Method: models.generateText

{
  "prompt": {
    object (TextPrompt)
  },
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "stopSequences": [
    string
  ],
  "temperature": number,
  "candidateCount": integer,
  "maxOutputTokens": integer,
  "topP": number,
  "topK": integer
}

object (TextPrompt)

مطلوبة. تمثّل هذه السمة نص الإدخال المرن الذي يتم منحه للنموذج كطلب.

عند تقديم مطالبة، سينشئ النموذج استجابة إكمال النص الذي يتوقّع إكماله للنص المُدخل.

object (SafetySetting)

اختياريّ. قائمة بمثيلات SafetySetting الفريدة لحظر المحتوى غير الآمن.

والتي سيتم فرضها على GenerateTextRequest.prompt وGenerateTextResponse.candidates يجب ألا يكون هناك أكثر من إعداد واحد لكل نوع SafetyCategory. ستحظر واجهة برمجة التطبيقات أي طلبات وردود لا تستوفي الحدود التي تحدّدها هذه الإعدادات. تلغي هذه القائمة الإعدادات التلقائية لكل SafetyCategory تم تحديدها في إعدادات الأمان. وإذا لم يتوفّر SafetySetting لعنصر SafetyCategory في القائمة، ستستخدِم واجهة برمجة التطبيقات إعداد الأمان التلقائي لهذه الفئة. يُسمح في الخدمة النصية بفئات الضرر HARM_CATEGORY_DEROGATORY وHARM_CATEGORY_TOXICITY وHARM_CATEGORY_VIOLENCE وHARM_CATEGORY_SEXUAL وHARM_CATEGORY_MEDical وHARM_CATEGORY_DANGEROUS.

string

مجموعة تسلسلات الأحرف (ما يصل إلى 5) التي ستعمل على إيقاف إنشاء الإخراج وفي حال تحديد ذلك، ستتوقف واجهة برمجة التطبيقات عند أول ظهور لتسلسل الإيقاف. لن يتم تضمين تسلسل الإيقاف كجزء من الاستجابة.

number

اختياريّ. تتحكّم هذه السياسة في التوزيع العشوائي للمخرجات. ملاحظة: تختلف القيمة التلقائية حسب الطراز. اطّلِع على السمة Model.temperature للدالة Model التي تم عرض الدالة getModel عليها.

يمكن أن تتراوح القيم من [0.0,1.0]، بشكل شامل. وستؤدي القيمة الأقرب من 1.0 إلى الحصول على ردود أكثر تنوعًا وإبداعًا، في حين تؤدي القيمة الأقرب من 0.0 عادةً إلى الحصول على ردود أكثر وضوحًا من النموذج.

integer

اختياريّ. عدد الردود التي تم إنشاؤها للعرض.

يجب أن تتراوح هذه القيمة بين [1 و8] بشكل شامل. وفي حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة تلقائيًا على 1.

integer

اختياريّ. تمثّل هذه السمة الحد الأقصى لعدد الرموز المميّزة المطلوب تضمينها في عنصر اختباري.

وفي حال ترك هذه السياسة بدون ضبط، سيتم ضبط الإدخال التلقائي على القيمة exitTokenLimit في مواصفات Model.

number

اختياريّ. الحد الأقصى للاحتمال التراكمي للرموز المميّزة التي يجب أخذها في الاعتبار عند أخذ العيّنات.

يستخدم النموذج عينة من القيم العليا والنواة معًا.

يتم تصنيف الرموز المميزة بناءً على الاحتمالات المخصصة لها، بحيث يتم أخذ الرموز المميزة الأكثر احتمالاً في الاعتبار فقط. يؤدي أخذ العينات من الدرجة الأولى إلى الحد مباشرةً من الحد الأقصى لعدد الرموز المميزة التي يجب أخذها في الاعتبار، بينما يحدد أخذ العينات Nucleus عدد الرموز المميزة بناءً على الاحتمال التراكمي.

ملاحظة: تختلف القيمة التلقائية حسب الطراز. اطّلِع على السمة Model.top_p للدالة Model التي تم عرض الدالة getModel عليها.

integer

اختياريّ. الحد الأقصى لعدد الرموز المميّزة التي يجب أخذها في الاعتبار عند أخذ عينات.

يستخدم النموذج عينة من القيم العليا والنواة معًا.

يراعي أخذ العينات من الدرجة الأولى مجموعة topK من الرموز المميزة الأكثر احتمالاً. يكون الإعداد التلقائي هو 40.

ملاحظة: تختلف القيمة التلقائية حسب الطراز. اطّلِع على السمة Model.top_k للدالة Model التي تم عرض الدالة getModel عليها.