تنشئ هذه الدالة استجابة من النموذج استنادًا إلى إدخال GenerateContentRequest
.
تختلف إمكانات الإدخال بين النماذج، بما في ذلك النماذج التي تم ضبطها. لمعرفة التفاصيل، يمكنك الاطّلاع على دليل النماذج ودليل الضبط.
طلب HTTP
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateContent
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
model |
مطلوبة. اسم التنسيق: |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "contents": [ { object ( |
الحقول | |
---|---|
contents[] |
مطلوبة. محتوى المحادثة الحالية مع النموذج. بالنسبة إلى طلبات البحث الأحادية الاتجاه، هذا مجرد مثيل واحد. بالنسبة إلى طلبات البحث المتعددة الأدوار، هذا حقل متكرّر يحتوي على سجلّ المحادثات وآخر طلب. |
tools[] |
اختياريّ. قائمة بـ
|
toolConfig |
اختياريّ. إعداد الأداة لأي |
safetySettings[] |
اختياريّ. قائمة بمثيلات وسيتم فرض ذلك على |
systemInstruction |
اختياريّ. تعليمات بشأن ضبط النظام من قِبل المطوّر وهي متاحة حاليًا عبر الرسائل النصية فقط. |
generationConfig |
اختياريّ. خيارات الضبط لإنشاء النماذج والنتائج |
cachedContent |
اختياريّ. اسم المحتوى المخزَّن مؤقتًا كسياق لعرض التوقّع. ملاحظة: لا تُستخدم هذه الواجهة إلّا في التخزين المؤقت الصريح، حيث يمكن للمستخدمين التحكّم في التخزين المؤقت (مثل المحتوى المطلوب تخزينه مؤقتًا) والاستفادة من توفير مضمون من التكاليف. تنسيق الملف: |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال 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
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة حول المصادقة.