Method: tunedModels.generateContent

تنشئ استجابة من النموذج استنادًا إلى الإدخال GenerateContentRequest.

طلب HTTP

POST https://generativelanguage.googleapis.com/v1beta/{model=tunedModels/*}:generateContent

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

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

المَعلمات
model

string

مطلوبة. تمثّل هذه السمة اسم Model المطلوب استخدامه لإنشاء المحتوى الكامل.

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

نص الطلب

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

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

object (Content)

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

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

tools[]

object (Tool)

اختياريّ. قائمة بـ Tools التي قد يستخدمها النموذج لإنشاء الردّ التالي

Tool هو جزء من الرمز البرمجي يتيح للنظام التفاعل مع الأنظمة الخارجية لتنفيذ إجراء أو مجموعة من الإجراءات، خارج نطاق توفّر النموذج ونطاقه. الأداة الوحيدة المتوافقة هي Function في الوقت الحالي.

toolConfig

object (ToolConfig)

اختياريّ. ضبط الأداة لأي Tool محدّدة في الطلب.

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.

systemInstruction

object (Content)

اختياريّ. تعليمات النظام الخاصة بالمطوِّر يتم حاليًا عرض الإعلانات النصية فقط.

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

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