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

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

في معظم حالات الاستخدام عند الوصول إلى نموذج Gemini، يمكنك ضبط النموذج باستخدام GenerationConfig. ومع ذلك، إذا كنت بصدد إعداد نموذج Gemini Live API، عليك استخدام LiveGenerationConfig.

توضّح هذه الصفحة كيفية إعداد عملية الضبط لنماذج Gemini وتقدّم وصفًا لكل مَعلمة.

الانتقال إلى إعدادات Gemini الانتقال إلى إعدادات Gemini Live API

‫GenerationConfig لطُرز Gemini

انقر على مقدّم خدمة Gemini API لعرض المحتوى والرمز الخاصين بمقدّم الخدمة على هذه الصفحة. Gemini Developer API Agent Platform Gemini API

يمكنك ضبط GenerationConfig لمعظم نماذج Gemini، بما في ذلك النماذج ذات الاستخدام العام ونماذج إنشاء الصور (نماذج "Nano Banana") ونماذج تحويل النص إلى كلام (TTS).

يتم الاحتفاظ بالإعدادات طوال مدة تشغيل مثيل GenerativeModel. إذا أردت استخدام إعدادات مختلفة، يمكنك إنشاء واستخدام مثيل جديد بإعدادات مختلفة.

Swift

اضبط قيم المَعلمات في GenerationConfig كجزء من إنشاء مثيل GenerativeModel.

import FirebaseAILogic

// Set parameter values in a `GenerationConfig`.
// IMPORTANT: Example values shown here. Make sure to update for your use case.
// Note that temperature, top-K, and top-P are deprecated and ignored by the latest Gemini models.
let config = GenerationConfig(
  candidateCount: 1,
  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`.
// IMPORTANT: Example values shown here. Make sure to update for your use case.
// Note that temperature, top-K, and top-P are deprecated and ignored by the latest Gemini models.
val config = generationConfig {
    candidateCount = 1
    maxOutputTokens = 200
    stopSequences = listOf("red")
}

// 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`.
// IMPORTANT: Example values shown here. Make sure to update for your use case.
// Note that temperature, top-K, and top-P are deprecated and ignored by the latest Gemini models.
GenerationConfig.Builder configBuilder = new GenerationConfig.Builder();
configBuilder.candidateCount = 1;
configBuilder.maxOutputTokens = 200;
configBuilder.stopSequences = List.of("red");

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`.
// IMPORTANT: Example values shown here. Make sure to update for your use case.
// Note that temperature, top-K, and top-P are deprecated and ignored by the latest Gemini models.
const generationConfig = {
  candidate_count: 1,
  maxOutputTokens: 200,
  stopSequences: ["red"],
};

// 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`.
// IMPORTANT: Example values shown here. Make sure to update for your use case.
// Note that temperature, top-K, and top-P are deprecated and ignored by the latest Gemini models.
final generationConfig = GenerationConfig(
  candidateCount: 1,
  maxOutputTokens: 200,
  stopSequences: ["red"],
);

// 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`.
// IMPORTANT: Example values shown here. Make sure to update for your use case.
// Note that temperature, top-K, and top-P are deprecated and ignored by the latest Gemini models.
var generationConfig = new GenerationConfig(
  candidateCount: 1,
  maxOutputTokens: 200,
  stopSequences: new string[] { "red" }
);

// Initialize the Gemini Developer API backend service.
// 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
);

يمكنك الاطّلاع على وصف لكل مَعلمة في القسم التالي من هذه الصفحة.

يمكنك تجربة الطلبات وإعدادات النماذج باستخدام Google AI Studio.

‫LiveGenerationConfig لطُرز Gemini Live API

انقر على مقدّم خدمة Gemini API لعرض المحتوى والرمز الخاصين بمقدّم الخدمة على هذه الصفحة. Gemini Developer API Agent Platform Gemini API

اضبط LiveGenerationConfig فقط عند استخدام نماذج Gemini Live API.

يتم الاحتفاظ بالإعدادات طوال مدة تشغيل مثيل LiveModel. إذا أردت استخدام إعدادات مختلفة، يمكنك إنشاء واستخدام مثيل جديد بإعدادات مختلفة.

Swift

اضبط قيم المَعلمات في liveGenerationConfig أثناء عملية تهيئة مثيل LiveModel:

// ...

// Set parameter values in a `LiveGenerationConfig` (example values shown here).
let config = LiveGenerationConfig(
  maxOutputTokens: 200,
  responseModalities: [.audio],
  speech: SpeechConfig(voiceName: "Fenrir"),
)

// Specify the config as part of creating the `liveModel` instance.
let liveModel = FirebaseAI.firebaseAI(backend: .googleAI()).liveModel(
  modelName: "GEMINI_LIVE_MODEL_NAME",
  generationConfig: config
)

// ...

Kotlin

اضبط قيم المَعلمات في LiveGenerationConfig كجزء من إنشاء مثيل LiveModel.

// ...

// Set parameter values in a `LiveGenerationConfig` (example values shown here).
val config = liveGenerationConfig {
    maxOutputTokens = 200
    responseModality = ResponseModality.AUDIO
    speechConfig = SpeechConfig(voice = Voices.FENRIR)
}

// Specify the config as part of creating the `LiveModel` instance.
val liveModel = Firebase.ai(backend = GenerativeBackend.agentPlatform()).liveModel(
    modelName = "GEMINI_LIVE_MODEL_NAME",
    generationConfig = config
)

// ...

Java

اضبط قيم المَعلمات في LiveGenerationConfig كجزء من إنشاء مثيل LiveModel.

// ...

// Set parameter values in a `LiveGenerationConfig` (example values shown here).
LiveGenerationConfig.Builder configBuilder = new LiveGenerationConfig.Builder();
configBuilder.setMaxOutputTokens(200);
configBuilder.setResponseModality(ResponseModality.AUDIO);

configBuilder.setSpeechConfig(new SpeechConfig(Voices.FENRIR));

LiveGenerationConfig config = configBuilder.build();

// Specify the config as part of creating the `LiveModel` instance.
LiveGenerativeModel lm = FirebaseAI.getInstance(GenerativeBackend.googleAI()).liveModel(
          "GEMINI_LIVE_MODEL_NAME",
          config
);

// ...

Web

اضبط قيم المَعلمات في LiveGenerationConfig أثناء عملية تهيئة مثيل LiveGenerativeModel:

// ...

// Initialize the Gemini Developer API backend service.
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Set parameter values in a `LiveGenerationConfig` (example values shown here).
const liveGenerationConfig = {
  maxOutputTokens: 200,
  responseModalities: [ResponseModality.AUDIO],
  speechConfig: {
    voiceConfig: {
      prebuiltVoiceConfig: { voiceName: "Fenrir" },
    },
  },
};

// Specify the config as part of creating the `LiveGenerativeModel` instance.
const liveModel = getLiveGenerativeModel(ai, {
  model: "GEMINI_LIVE_MODEL_NAME",
  liveGenerationConfig,
});

// ...

Dart

اضبط قيم المَعلمات في LiveGenerationConfig كجزء من إنشاء مثيل LiveGenerativeModel.

// ...

// Set parameter values in a `LiveGenerationConfig` (example values shown here).
final config = LiveGenerationConfig(
  maxOutputTokens: 200,
  responseModalities: [ResponseModalities.audio],
  speechConfig: SpeechConfig(voiceName: 'Fenrir'),
);

// Specify the config as part of creating the `liveGenerativeModel` instance.
final liveModel = FirebaseAI.googleAI().liveGenerativeModel(
  model: 'GEMINI_LIVE_MODEL_NAME',
  liveGenerationConfig: config,
);

// ...

Unity

اضبط قيم المَعلمات في LiveGenerationConfig كجزء من إنشاء مثيل LiveModel.

// ...

// Set parameter values in a `LiveGenerationConfig` (example values shown here).
var config = new LiveGenerationConfig(
  maxOutputTokens: 200,
  responseModalities: new[] { ResponseModality.Audio },
  speechConfig: SpeechConfig.UsePrebuiltVoice("Fenrir")
);

// Specify the config as part of creating the `LiveModel` instance.
var liveModel = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI()).GetLiveModel(
  modelName: "GEMINI_LIVE_MODEL_NAME",
  liveGenerationConfig: config
);

// ...

يمكنك الاطّلاع على وصف لكل مَعلمة في القسم التالي من هذه الصفحة.

يمكنك تجربة الطلبات وإعدادات النماذج باستخدام Google AI Studio.

---

وصف المَعلمات

الجدول التالي هو نظرة عامة عالية المستوى على المَعلمات المتاحة. لا تنطبق بعض المَعلمات إلا على طُرز معيّنة.

يُرجى العِلم أنّه تم إيقاف درجة العشوائية وأعلى K كلمة محتملة وأعلى احتمال تراكمي، وتتجاهلها أحدث طُرز Gemini.

المَعلمة	الوصف	القيود	القيمة التلقائية
الطابع الزمني للصوت audioTimestamp	تتيح فهم الطوابع الزمنية لملفات الإدخال الصوتية فقط.	قيمة منطقية لا ينطبق ذلك إلا عند استخدام إعداد GenerativeModel وكان نوع الإدخال ملفًا صوتيًا فقط.	false
عدد المرشحين candidateCount	تحدّد هذه السمة عدد صيغ الردود المطلوب عرضها. في كل طلب، يتم تحصيل رسوم منك مقابل الرموز المميزة للناتج من جميع المرشحين، ولكن يتم تحصيل الرسوم منك مرة واحدة فقط مقابل الرموز المميزة للإدخال.	القيم المسموح بها: 1 - 8 (ضمنًا) لا ينطبق ذلك إلا عند استخدام generateContent. لا ينطبق ذلك عند استخدام نماذج generateContentStream أو نماذج تحويل النص إلى كلام أو نماذج Live API.	1
أقصى عدد لرموز الناتج المميّزة maxOutputTokens	تحدّد هذه السمة الحد الأقصى لعدد الرموز المميّزة التي يمكن إنشاؤها في الرد.	---	---
عقوبة التكرار frequencyPenalty	تتحكّم في احتمال تضمين الرموز المميزة التي تظهر بشكل متكرر في الرد الذي تم إنشاؤه. تؤدي القيم الموجبة إلى فرض عقوبة على الرموز المميزة التي تظهر بشكل متكرّر في المحتوى الذي تم إنشاؤه، ما يقلّل من احتمال تكرار المحتوى.	لا ينطبق ذلك على نماذج تحويل النص إلى كلام.	---
عقوبة عدم الحضور presencePenalty	تتحكّم هذه السمة في احتمال تضمين رموز مميّزة تظهر في الردّ الذي تم إنشاؤه. تؤدي القيم الموجبة إلى فرض عقوبة على الرموز المميزة التي تظهر في المحتوى الذي تم إنشاؤه، ما يزيد من احتمالية إنشاء محتوى أكثر تنوعًا.	لا ينطبق ذلك على نماذج تحويل النص إلى كلام.	---
إيقاف التسلسلات stopSequences	تحدّد هذه السمة قائمة بالسلاسل التي تطلب من النموذج التوقّف عن إنشاء المحتوى إذا صادف إحدى السلاسل في الردّ.	لا ينطبق هذا الخيار إلا عند استخدام إعدادات GenerativeModel. لا ينطبق ذلك على نماذج تحويل النص إلى كلام.	---
الإعدادات المتخصّصة
التفكير thinkingConfig	تتحكّم هذه المَعلمة في "عملية التفكير" التي تتبعها النماذج عند إنشاء رد. يمكنك التحكّم في مقدار التفكير الذي يمكن أن يجريه النموذج باستخدام مستوى التفكير (في نماذج Gemini 3.x والإصدارات الأحدث). تحديد ما إذا كنت تريد تضمين ملخّصات الأفكار	القيم المسموح بها: يمكنك الاطّلاع على مستندات التفكير لا ينطبق ذلك على نماذج تحويل النص إلى كلام. Firebase AI Logic لا تتيح بعد ضبط thinkingConfig لنماذج Live API.	حسب الطراز
طُرق الردّ responseModalities	تحدّد هذه السمة نوع الناتج (مثل النص أو الصوت أو الصور).	لا ينطبق هذا الشرط (وهو إلزامي) إلا عند استخدام Gemini نماذج الصور (نماذج "Nano Banana")، ونماذج تحويل النص إلى كلام، ونماذج Live API.	---
خصائص الصور imageConfig	تحدّد هذه السمة نسبة العرض إلى الارتفاع ودرجة الدقة للصور التي يتم إنشاؤها.	القيم المسموح بها: راجِع مقالة ضبط إعدادات إنشاء الصور ينطبق ذلك فقط عند استخدام Gemini نماذج الصور (نماذج "Nano Banana").	نسبة العرض إلى الارتفاع 1:1 (مربّع) درجة الدقة 1024x1024
الكلام (الصوت) speechConfig	تحدّد هذه السمة الصوت المستخدَم لإخراج الصوت.	لا ينطبق هذا الإعداد إلا عند استخدام نماذج تحويل النص إلى كلام ونماذج Live API. مطلوب لنماذج تحويل النص إلى كلام.	Puck

ملاحظة: تتوفّر أيضًا عمليات الضبط التالية في GenerationConfig:

• يتم التحكّم في إنشاء إخراج منظَّم (مثل JSON) باستخدام المَعلمتَين responseMimeType وresponseSchema.
  لا يمكن استخدام هذه المَعلمات إلا مع نماذج النصوص ذات الاستخدام العام (وليس مع نماذج الصور Gemini ("نماذج Nano Banana")، أو نماذج تحويل النص إلى كلام، أو نماذج Live API).

إيقاف مَعلمات "درجة العشوائية" و"أعلى K كلمة محتملة" و"أعلى احتمال تراكمي"

تم إيقاف مَعلّمات temperature وtopK وtopP، وتتجاهلها نماذج gemini-3.7-flash وgemini-3.6-flash وgemini-3.5-flash-lite. للحصول على ردود أكثر تحديدًا، حدِّد تعليمات النظام باستخدام قواعد واضحة لحالة الاستخدام المحدّدة.

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

---

ضبط نماذج Imagen

سيتم إيقاف جميع طُرز Imagen نهائيًا اعتبارًا من 17 أغسطس 2026. كبديل، يمكنك نقل تطبيقاتك لاستخدام Gemini نماذج معالجة الصور (نماذج "Nano Banana").

انقر على مقدّم خدمة Imagen API لعرض المحتوى والرمز الخاصين بمقدّم الخدمة على هذه الصفحة. Gemini Developer API Agent Platform Gemini API

يوضّح لك هذا القسم كيفية إعداد عملية ضبط لاستخدامها مع نماذج Imagen، كما يقدّم وصفًا لكل مَعلمة.

إعداد نموذج إعداد (Imagen)

يتم الاحتفاظ بالإعدادات طوال مدة تشغيل الجهاز الافتراضي. إذا أردت استخدام إعداد مختلف، أنشئ مثيلاً جديدًا من ImagenModel باستخدام هذا الإعداد.

Swift

اضبط قيم المَعلمات في ImagenGenerationConfig كجزء من إنشاء مثيل ImagenModel.

import FirebaseAILogic

// 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

اضبط قيم المَعلمات في ImagenGenerationConfig كجزء من إنشاء مثيل ImagenModel.

using Firebase.AI;

// Set parameter values in a `ImagenGenerationConfig` (example values shown here)
var config = new ImagenGenerationConfig(
  numberOfImages: 2,
  aspectRatio: ImagenAspectRatio.Landscape16x9,
  imageFormat: ImagenImageFormat.Jpeg(100)
);

// Initialize the Gemini Developer API backend service
// Specify the config as part of creating the `ImagenModel` instance
var model = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI()).GetImagenModel(
  modelName: "imagen-4.0-generate-001",
  generationConfig: config
);

// ...

يمكنك الاطّلاع على وصف لكل مَعلمة في القسم التالي من هذه الصفحة.

وصف المَعلمات (Imagen)

في ما يلي نظرة عامة على مستوى عالٍ على المَعلمات المتاحة، حسب الاقتضاء.

المَعلمة	الوصف	القيمة التلقائية
الطلب السلبي negativePrompt	وصف للعناصر التي تريد استبعادها من الصور التي يتم إنشاؤها لم يعُد هذا المَعلم متاحًا في imagen-3.0-generate-002.	---
عدد النتائج numberOfImages	عدد الصور التي تم إنشاؤها والتي يتم عرضها لكل طلب	القيمة التلقائية هي صورة واحدة
نسبة العرض إلى الارتفاع aspectRatio	نسبة عرض الصور التي تم إنشاؤها إلى ارتفاعها	القيمة التلقائية هي مربّع (1:1)
تنسيق الصورة imageFormat	خيارات الإخراج، مثل تنسيق الصورة (نوع MIME) ومستوى ضغط الصور التي تم إنشاؤها	نوع MIME التلقائي هو PNG مستوى الضغط التلقائي هو 75 (في حال ضبط نوع MIME على JPEG)
العلامة المائية addWatermark	تحديد ما إذا كنت تريد إضافة علامة مائية رقمية غير مرئية (تُعرف باسم SynthID) إلى الصور التي يتم إنشاؤها	القيمة التلقائية هي true
إنشاء صور أشخاص personGeneration	ما إذا كان النموذج يسمح بإنشاء صور لأشخاص	يعتمد الإعداد التلقائي على النموذج
تضمين سمات الأمان includeSafetyAttributes	تحديد ما إذا كان سيتم تفعيل تقييمات الذكاء الاصطناعي المسؤول المقرَّبة لقائمة من سمات الأمان في الردود على المدخلات والمخرجات غير المفلترة فئات سمات الأمان: "Death, Harm & Tragedy", "Firearms & Weapons", "Hate", "Health", "Illicit Drugs", "Politics", "Porn", "Religion & Belief", "Toxic", "Violence", "Vulgarity", "War & Conflict".	القيمة التلقائية هي false

ملاحظة: Firebase AI Logic لا يتيح بعد المَعلمات التالية:

• تحديد رقم أساسي (المَعلمة seed)
• ضبط حزمة Google Cloud Storage لتخزين الصور التي تم إنشاؤها (المَعلمة storageUri)
• إيقاف تحسين الطلبات (المَعلمة enhancePrompt)

---

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

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