Method: models.generateContent

تنشئ استجابة من النموذج المحدد في الإدخال GenerateContentRequest.

طلب HTTP

POST https://generativelanguage.googleapis.com/v1/{model=models/*}:generateContent

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
model

string

مطلوبة. اسم السمة Model المطلوب استخدامها لإنشاء الإكمال.

تنسيق الملف: name=models/{model}

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON
{
  "contents": [
    {
      object (Content)
    }
  ],
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "generationConfig": {
    object (GenerationConfig)
  }
}
الحقول
contents[]

object (Content)

مطلوبة. محتوى المحادثة الحالية مع النموذج.

بالنسبة للاستعلامات أحادية الدور، يعد هذا مثيلاً واحدًا. بالنسبة إلى طلبات البحث المتعدّدة الأدوار، يكون هذا حقلاً متكرّرًا يحتوي على سجلّ المحادثة وآخر طلب.

safetySettings[]

object (SafetySetting)

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

سيتم فرض ذلك على GenerateContentRequest.contents وGenerateContentResponse.candidates. يجب ألا يكون هناك أكثر من إعداد واحد لكل نوع SafetyCategory. ستحظر واجهة برمجة التطبيقات أي محتوى وردود لا تستوفي الحدود التي وضعتها هذه الإعدادات. تلغي هذه القائمة الإعدادات التلقائية لكل SafetyCategory تم تحديدها في إعدادات الأمان. وإذا لم يتوفّر SafetySetting لعنصر SafetyCategory في القائمة، ستستخدِم واجهة برمجة التطبيقات إعداد الأمان التلقائي لهذه الفئة. يُسمح باستخدام فئات الضرر HARM_CATEGORY_HATE_SPEECH وHARM_CATEGORY_SEXUALLY_EXPLICIT وHARM_CATEGORY_DANGEROUS_CONTENT وHARM_CATEGORY_HARASSMENT.

generationConfig

object (GenerationConfig)

اختياريّ. خيارات الإعدادات لإنشاء النموذج ومخرجاته

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال GenerateContentResponse.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/generative-language
  • https://www.googleapis.com/auth/generative-language.tuning
  • https://www.googleapis.com/auth/generative-language.tuning.readonly
  • https://www.googleapis.com/auth/generative-language.retriever
  • https://www.googleapis.com/auth/generative-language.retriever.readonly

لمزيد من المعلومات، راجع نظرة عامة على المصادقة.