استخدام إعدادات النموذج للتحكّم في الردود

في كل طلب يتم إرساله إلى نموذج، يمكنك إرسال إعدادات ضبط النموذج للتحكّم في طريقة إنشاء النموذج للرد. يوفّر كل نموذج خيارات إعداد مختلفة.

يمكنك أيضًا تجربة الطلبات وإعدادات النماذج باستخدام 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

قيمة منطقية تتيح فهم الطوابع الزمنية لملفات الإدخال الصوتي فقط.

لا ينطبق ذلك إلا عند استخدام مكالمات generateContent أو generateContentStream وكان نوع الإدخال ملفًا صوتيًا فقط.

false
عقوبة التكرار
frequencyPenalty
تتحكّم هذه السمة في احتمالية تضمين الرموز المميزة التي تظهر بشكل متكرر في الرد الذي تم إنشاؤه.
تؤدي القيم الموجبة إلى فرض عقوبة على الرموز المميزة التي تظهر بشكل متكرر في المحتوى الذي تم إنشاؤه، ما يقلّل من احتمال تكرار المحتوى.
---
الحدّ الأقصى لعدد الرموز المميزة للناتج
maxOutputTokens
تحدّد هذه السمة الحد الأقصى لعدد الرموز المميّزة التي يمكن إنشاؤها في الرد. ---
عقوبة الحضور
presencePenalty
تتحكّم هذه السمة في احتمالية تضمين الرموز المميزة التي تظهر في الرد الذي تم إنشاؤه.
تعاقب القيم الموجبة الرموز المميزة التي تظهر في المحتوى الذي تم إنشاؤه، ما يزيد من احتمال إنشاء محتوى أكثر تنوعًا.
---
تسلسلات الإيقاف
stopSequences

تحدّد هذه السمة قائمة بالسلاسل التي تطلب من النموذج التوقّف عن إنشاء المحتوى إذا تم العثور على إحدى السلاسل في الرد.

لا ينطبق هذا الإعداد إلا عند استخدام إعدادات GenerativeModel.

---
درجة الحرارة
temperature
تتحكّم هذه السمة في درجة العشوائية في الردّ.
تؤدي درجات الحرارة المنخفضة إلى الحصول على ردود أكثر تحديدًا، بينما تؤدي درجات الحرارة المرتفعة إلى الحصول على ردود أكثر تنوعًا أو إبداعًا.
حسب الطراز
Top-K
topK
يحدّ هذا الحقل من عدد الكلمات ذات الاحتمالية الأعلى للاستخدام في المحتوى الذي يتم إنشاؤه.
تعني قيمة top-K البالغة 1 أنّ الرمز المميز التالي الذي سيتم اختياره يجب أن يكون الأكثر احتمالاً بين جميع الرموز المميزة في مفردات النموذج، بينما تعني قيمة top-K البالغة n أنّ الرمز المميز التالي يجب أن يتم اختياره من بين الرموز المميزة n الأكثر احتمالاً (كل ذلك استنادًا إلى درجة الحرارة المحدّدة).
حسب الطراز
Top-P
topP
تتحكّم هذه السمة في تنوّع المحتوى الذي يتم إنشاؤه.
يتم اختيار الرموز المميزة من الأكثر احتمالاً (انظر top-K أعلاه) إلى الأقل احتمالاً إلى أن يساوي مجموع احتمالاتها قيمة top-P.
حسب الطراز
طريقة الرد
responseModality

تحدّد هذه السمة نوع الناتج الذي يتم بثه عند استخدام السمة Live API أو الناتج الأصلي المتعدّد الوسائط الذي يوفّره النموذج Gemini، مثل النصوص أو الصوت أو الصور.

لا ينطبق ذلك إلا عند استخدام إعدادات Live API وLiveModel، أو عند استخدام طراز Gemini قادر على إخراج بيانات متعددة الوسائط.

---
الكلام (الصوت)
speechConfig

تحدّد هذه السمة الصوت المستخدَم لإخراج الصوت الذي يتم بثه عند استخدام Live API.

ينطبق ذلك فقط عند استخدام إعدادات Live API وLiveModel.

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
وصف للعناصر التي تريد استبعادها من الصور التي يتم إنشاؤها

لم يعُد هذا المَعلمة متاحًا في imagen-3.0-generate-002.

---
عدد النتائج
numberOfImages
عدد الصور التي تم إنشاؤها والتي يتم عرضها لكل طلب الإعداد التلقائي هو صورة واحدة لطُرز Imagen 3
نسبة العرض إلى الارتفاع
aspectRatio
نسبة عرض الصور التي تم إنشاؤها إلى ارتفاعها القيمة التلقائية هي مربّع (1:1)
تنسيق الصورة
imageFormat
خيارات الإخراج، مثل تنسيق الصورة (نوع MIME) ومستوى ضغط الصور التي تم إنشاؤها نوع MIME التلقائي هو PNG
مستوى الضغط التلقائي هو 75 (في حال ضبط نوع MIME على JPEG)
العلامة المائية
addWatermark
ما إذا كان سيتم إضافة علامة مائية رقمية غير مرئية (تُعرف باسم SynthID) إلى الصور التي يتم إنشاؤها القيمة التلقائية هي true لنماذج Imagen 3
إنشاء أشخاص
personGeneration
ما إذا كان النموذج يسمح بإنشاء صور لأشخاص يعتمد الإعداد التلقائي على النموذج



خيارات أخرى للتحكّم في إنشاء المحتوى

  • مزيد من المعلومات حول تصميم الطلبات لتتمكّن من التأثير في النموذج لإنشاء ناتج محدّد يناسب احتياجاتك
  • استخدِم إعدادات الأمان لتعديل احتمالية تلقّي ردود قد تُعتبر ضارة، بما في ذلك خطاب الكراهية والمحتوى الجنسي الفاضح.
  • اضبط تعليمات النظام لتوجيه سلوك النموذج. هذه الميزة تشبه المقدمة التي تضيفها قبل أن يتلقّى النموذج أي تعليمات أخرى من المستخدم النهائي.
  • مرِّر مخطط الردود مع الطلب لتحديد مخطط ناتج معيّن. تُستخدَم هذه الميزة بشكل شائع عند إنشاء مخرجات بتنسيق JSON، ولكن يمكن استخدامها أيضًا في مهام التصنيف (مثل عندما تريد أن يستخدم النموذج تصنيفات أو علامات معيّنة).