في كل طلب يتم إرساله إلى نموذج، يمكنك إرسال إعدادات ضبط النموذج للتحكّم في طريقة إنشاء النموذج للرد. يوفّر كل نموذج خيارات إعداد مختلفة.
يمكنك أيضًا تجربة الطلبات وإعدادات النماذج باستخدام Google AI Studio.Gemini الانتقال إلى خيارات الضبط في Imagen الانتقال إلى خيارات الضبط في
ضبط طُرز Gemini
انقر على مزوّد Gemini API لعرض المحتوى والرمز الخاصين بالمزوّد على هذه الصفحة. |
يوضّح لك هذا القسم كيفية إعداد عملية ضبط لاستخدامها مع نماذج Gemini، ويقدّم وصفًا لكل مَعلمة.
إعداد إعدادات نموذجية (Gemini)
إعدادات حالات الاستخدام العامة
يتم الاحتفاظ بالإعدادات طوال مدة تشغيل الجهاز الافتراضي. إذا أردت استخدام إعداد مختلف، أنشئ مثيلاً جديدًا من GenerativeModel
باستخدام هذا الإعداد.
Swift
اضبط قيم المَعلمات في GenerationConfig
كجزء من إنشاء مثيل GenerativeModel
.
import FirebaseAI
// Set parameter values in a `GenerationConfig` (example values shown here)
let config = GenerationConfig(
temperature: 0.9,
topP: 0.1,
topK: 16,
maxOutputTokens: 200,
stopSequences: ["red"]
)
// Initialize the Gemini Developer API backend service
// Specify the config as part of creating the `GenerativeModel` instance
let model = FirebaseAI.firebaseAI(backend: .googleAI()).generativeModel(
modelName: "GEMINI_MODEL_NAME",
generationConfig: config
)
// ...
Kotlin
اضبط قيم المَعلمات في GenerationConfig
كجزء من إنشاء مثيل GenerativeModel
.
// ...
// Set parameter values in a `GenerationConfig` (example values shown here)
val config = generationConfig {
maxOutputTokens = 200
stopSequences = listOf("red")
temperature = 0.9f
topK = 16
topP = 0.1f
}
// Initialize the Gemini Developer API backend service
// Specify the config as part of creating the `GenerativeModel` instance
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).generativeModel(
modelName = "GEMINI_MODEL_NAME",
generationConfig = config
)
// ...
Java
اضبط قيم المَعلمات في GenerationConfig
كجزء من إنشاء مثيل GenerativeModel
.
// ...
// Set parameter values in a `GenerationConfig` (example values shown here)
GenerationConfig.Builder configBuilder = new GenerationConfig.Builder();
configBuilder.maxOutputTokens = 200;
configBuilder.stopSequences = List.of("red");
configBuilder.temperature = 0.9f;
configBuilder.topK = 16;
configBuilder.topP = 0.1f;
GenerationConfig config = configBuilder.build();
// Specify the config as part of creating the `GenerativeModel` instance
GenerativeModelFutures model = GenerativeModelFutures.from(
FirebaseAI.getInstance(GenerativeBackend.googleAI())
.generativeModel(
"GEMINI_MODEL_NAME",
config
);
);
// ...
Web
اضبط قيم المَعلمات في GenerationConfig
كجزء من إنشاء مثيل GenerativeModel
.
// ...
// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });
// Set parameter values in a `GenerationConfig` (example values shown here)
const generationConfig = {
max_output_tokens: 200,
stop_sequences: ["red"],
temperature: 0.9,
top_p: 0.1,
top_k: 16,
};
// Specify the config as part of creating the `GenerativeModel` instance
const model = getGenerativeModel(ai, { model: "GEMINI_MODEL_NAME", generationConfig });
// ...
Dart
اضبط قيم المَعلمات في GenerationConfig
كجزء من إنشاء مثيل GenerativeModel
.
// ...
// Set parameter values in a `GenerationConfig` (example values shown here)
final generationConfig = GenerationConfig(
maxOutputTokens: 200,
stopSequences: ["red"],
temperature: 0.9,
topP: 0.1,
topK: 16,
);
// Initialize the Gemini Developer API backend service
// Specify the config as part of creating the `GenerativeModel` instance
final model = FirebaseAI.googleAI().generativeModel(
model: 'GEMINI_MODEL_NAME',
config: generationConfig,
);
// ...
Unity
اضبط قيم المَعلمات في GenerationConfig
كجزء من إنشاء مثيل GenerativeModel
.
// ...
// Set parameter values in a `GenerationConfig` (example values shown here)
var generationConfig = new GenerationConfig(
maxOutputTokens: 200,
stopSequences: new string[] { "red" },
temperature: 0.9f,
topK: 16,
topP: 0.1f
);
// Specify the config as part of creating the `GenerativeModel` instance
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());
var model = ai.GetGenerativeModel(
modelName: "GEMINI_MODEL_NAME",
generationConfig: generationConfig
);
يمكنك الاطّلاع على وصف لكل مَعلمة في القسم التالي من هذه الصفحة.
إعدادات Gemini Live API
وصف المَعلمات (Gemini)
في ما يلي نظرة عامة على مستوى عالٍ على المَعلمات المتاحة، حسب الاقتضاء. يمكنك الاطّلاع على قائمة شاملة بالمعلَمات وقيمها في مستندات Gemini Developer API.
المَعلمة | الوصف | القيمة التلقائية |
---|---|---|
الطابع الزمني للصوت
audioTimestamp
|
قيمة منطقية تتيح فهم الطوابع الزمنية لملفات الإدخال الصوتي فقط. لا ينطبق ذلك إلا عند استخدام مكالمات |
false |
عقوبة التكرار
frequencyPenalty
|
تتحكّم هذه السمة في احتمالية تضمين الرموز المميزة التي تظهر بشكل متكرر في الرد الذي تم إنشاؤه. تؤدي القيم الموجبة إلى فرض عقوبة على الرموز المميزة التي تظهر بشكل متكرر في المحتوى الذي تم إنشاؤه، ما يقلّل من احتمال تكرار المحتوى. |
--- |
الحدّ الأقصى لعدد الرموز المميزة للناتج
maxOutputTokens
|
تحدّد هذه السمة الحد الأقصى لعدد الرموز المميّزة التي يمكن إنشاؤها في الرد. | --- |
عقوبة الحضور
presencePenalty
|
تتحكّم هذه السمة في احتمالية تضمين الرموز المميزة التي تظهر في الرد الذي تم إنشاؤه. تعاقب القيم الموجبة الرموز المميزة التي تظهر في المحتوى الذي تم إنشاؤه، ما يزيد من احتمال إنشاء محتوى أكثر تنوعًا. |
--- |
تسلسلات الإيقاف
stopSequences
|
تحدّد هذه السمة قائمة بالسلاسل التي تطلب من النموذج التوقّف عن إنشاء المحتوى إذا تم العثور على إحدى السلاسل في الرد. لا ينطبق هذا الإعداد إلا عند استخدام إعدادات |
--- |
درجة الحرارة
temperature
|
تتحكّم هذه السمة في درجة العشوائية في الردّ. تؤدي درجات الحرارة المنخفضة إلى الحصول على ردود أكثر تحديدًا، بينما تؤدي درجات الحرارة المرتفعة إلى الحصول على ردود أكثر تنوعًا أو إبداعًا. |
حسب الطراز |
Top-K
topK
|
يحدّ هذا الحقل من عدد الكلمات ذات الاحتمالية الأعلى للاستخدام في المحتوى الذي يتم إنشاؤه. تعني قيمة top-K البالغة 1 أنّ الرمز المميز التالي الذي سيتم اختياره يجب أن يكون
الأكثر احتمالاً بين جميع الرموز المميزة في مفردات النموذج،
بينما تعني قيمة top-K البالغة n أنّ الرمز المميز التالي يجب أن
يتم اختياره من بين الرموز المميزة n الأكثر احتمالاً
(كل ذلك استنادًا إلى درجة الحرارة المحدّدة).
|
حسب الطراز |
Top-P
topP
|
تتحكّم هذه السمة في تنوّع المحتوى الذي يتم إنشاؤه. يتم اختيار الرموز المميزة من الأكثر احتمالاً (انظر top-K أعلاه) إلى الأقل احتمالاً إلى أن يساوي مجموع احتمالاتها قيمة top-P. |
حسب الطراز |
طريقة الرد
responseModality
|
تحدّد هذه السمة نوع الناتج الذي يتم بثه عند استخدام السمة Live API أو الناتج الأصلي المتعدّد الوسائط الذي يوفّره النموذج Gemini، مثل النصوص أو الصوت أو الصور. لا ينطبق ذلك إلا عند استخدام إعدادات Live API و |
--- |
الكلام (الصوت)
speechConfig
|
تحدّد هذه السمة الصوت المستخدَم لإخراج الصوت الذي يتم بثه عند استخدام Live API. ينطبق ذلك فقط عند استخدام إعدادات Live API و |
Puck |
ضبط طُرز Imagen
انقر على مزوّد Imagen API لعرض المحتوى والرمز الخاصين بالمزوّد على هذه الصفحة. |
يوضّح لك هذا القسم كيفية إعداد عملية ضبط لاستخدامها مع نماذج Imagen، ويقدّم وصفًا لكل مَعلمة.
إعداد إعدادات نموذجية (Imagen)
يتم الاحتفاظ بالإعدادات طوال مدة تشغيل الجهاز الافتراضي. إذا أردت استخدام إعداد مختلف، أنشئ مثيلاً جديدًا من ImagenModel
باستخدام هذا الإعداد.
Swift
اضبط قيم المَعلمات في
ImagenGenerationConfig
كجزء من إنشاء مثيل ImagenModel
.
import FirebaseAI
// Set parameter values in a `ImagenGenerationConfig` (example values shown here)
let config = ImagenGenerationConfig(
negativePrompt: "frogs",
numberOfImages: 2,
aspectRatio: .landscape16x9,
imageFormat: .jpeg(compressionQuality: 100),
addWatermark: false
)
// Initialize the Gemini Developer API backend service
// Specify the config as part of creating the `ImagenModel` instance
let model = FirebaseAI.firebaseAI(backend: .googleAI()).imagenModel(
modelName: "IMAGEN_MODEL_NAME",
generationConfig: config
)
// ...
Kotlin
اضبط قيم المَعلمات في
ImagenGenerationConfig
كجزء من إنشاء مثيل ImagenModel
.
// ...
// Set parameter values in a `ImagenGenerationConfig` (example values shown here)
val config = ImagenGenerationConfig {
negativePrompt = "frogs",
numberOfImages = 2,
aspectRatio = ImagenAspectRatio.LANDSCAPE_16x9,
imageFormat = ImagenImageFormat.jpeg(compressionQuality = 100),
addWatermark = false
}
// Initialize the Gemini Developer API backend service
// Specify the config as part of creating the `GenerativeModel` instance
val model = Firebase.ai(backend = GenerativeBackend.vertexAI()).imagenModel(
modelName = "IMAGEN_MODEL_NAME",
generationConfig = config
)
// ...
Java
اضبط قيم المَعلمات في
ImagenGenerationConfig
كجزء من إنشاء مثيل ImagenModel
.
// ...
// Set parameter values in a `ImagenGenerationConfig` (example values shown here)
ImagenGenerationConfig config = new ImagenGenerationConfig.Builder()
.setNegativePrompt("frogs")
.setNumberOfImages(2)
.setAspectRatio(ImagenAspectRatio.LANDSCAPE_16x9)
.setImageFormat(ImagenImageFormat.jpeg(100))
.setAddWatermark(false)
.build();
// Specify the config as part of creating the `ImagenModel` instance
ImagenModelFutures model = ImagenModelFutures.from(
FirebaseAI.getInstance(GenerativeBackend.googleAI())
.imagenModel(
"IMAGEN_MODEL_NAME",
config
);
);
// ...
Web
اضبط قيم المَعلمات في
ImagenGenerationConfig
كجزء من إنشاء مثيل ImagenModel
.
// ...
// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });
// Set parameter values in a `ImagenGenerationConfig` (example values shown here)
const generationConfig = {
negativePrompt: "frogs",
numberOfImages: 2,
aspectRatio: ImagenAspectRatio.LANDSCAPE_16x9,
imageFormat: ImagenImageFormat.jpeg(100),
addWatermark: false
};
// Specify the config as part of creating the `ImagenModel` instance
const model = getImagenModel(ai, { model: "IMAGEN_MODEL_NAME", generationConfig });
// ...
Dart
اضبط قيم المَعلمات في
ImagenGenerationConfig
كجزء من إنشاء مثيل ImagenModel
.
// ...
// Set parameter values in a `ImagenGenerationConfig` (example values shown here)
final generationConfig = ImagenGenerationConfig(
negativePrompt: 'frogs',
numberOfImages: 2,
aspectRatio: ImagenAspectRatio.landscape16x9,
imageFormat: ImagenImageFormat.jpeg(compressionQuality: 100)
addWatermark: false
);
// Initialize the Gemini Developer API backend service
// Specify the config as part of creating the `ImagenModel` instance
final model = FirebaseAI.googleAI().imagenModel(
model: 'IMAGEN_MODEL_NAME',
config: generationConfig,
);
// ...
Unity
لا تتوافق Imagen مع Unity بعد، ولكن يمكنك التحقّق مرة أخرى قريبًا.
يمكنك الاطّلاع على وصف لكل مَعلمة في القسم التالي من هذه الصفحة.
وصف المَعلمات (Imagen)
في ما يلي نظرة عامة على مستوى عالٍ على المَعلمات المتاحة، حسب الاقتضاء. يمكنك الاطّلاع على قائمة شاملة بالمعلَمات وقيمها في مستندات Google Cloud.
المَعلمة | الوصف | القيمة التلقائية |
---|---|---|
الطلب السلبي
negativePrompt
|
وصف للعناصر التي تريد استبعادها من الصور التي يتم إنشاؤها
لم يعُد هذا المَعلمة متاحًا في |
--- |
عدد النتائج
numberOfImages
|
عدد الصور التي تم إنشاؤها والتي يتم عرضها لكل طلب | الإعداد التلقائي هو صورة واحدة لطُرز Imagen 3 |
نسبة العرض إلى الارتفاع
aspectRatio
|
نسبة عرض الصور التي تم إنشاؤها إلى ارتفاعها | القيمة التلقائية هي مربّع (1:1) |
تنسيق الصورة
imageFormat
|
خيارات الإخراج، مثل تنسيق الصورة (نوع MIME) ومستوى ضغط الصور التي تم إنشاؤها | نوع MIME التلقائي هو PNG مستوى الضغط التلقائي هو 75 (في حال ضبط نوع MIME على JPEG) |
العلامة المائية
addWatermark
|
ما إذا كان سيتم إضافة علامة مائية رقمية غير مرئية (تُعرف باسم SynthID) إلى الصور التي يتم إنشاؤها | القيمة التلقائية هي true لنماذج Imagen 3
|
إنشاء أشخاص
personGeneration
|
ما إذا كان النموذج يسمح بإنشاء صور لأشخاص | يعتمد الإعداد التلقائي على النموذج |
خيارات أخرى للتحكّم في إنشاء المحتوى
- مزيد من المعلومات حول تصميم الطلبات لتتمكّن من التأثير في النموذج لإنشاء ناتج محدّد يناسب احتياجاتك
- استخدِم إعدادات الأمان لتعديل احتمالية تلقّي ردود قد تُعتبر ضارة، بما في ذلك خطاب الكراهية والمحتوى الجنسي الفاضح.
- اضبط تعليمات النظام لتوجيه سلوك النموذج. هذه الميزة تشبه المقدمة التي تضيفها قبل أن يتلقّى النموذج أي تعليمات أخرى من المستخدم النهائي.
- مرِّر مخطط الردود مع الطلب لتحديد مخطط ناتج معيّن. تُستخدَم هذه الميزة بشكل شائع عند إنشاء مخرجات بتنسيق JSON، ولكن يمكن استخدامها أيضًا في مهام التصنيف (مثل عندما تريد أن يستخدم النموذج تصنيفات أو علامات معيّنة).