GenerateContentResponse

رد من النموذج يدعم عدة مرشحين.

ملاحظة بشأن تقييمات الأمان وفلترة المحتوى يتم الإبلاغ عنها لكل من الطلب في GenerateContentResponse.prompt_feedback ولكل مرشّح في finishReason وفي safetyRatings. ينص عقد واجهة برمجة التطبيقات على ما يلي: إما عرض جميع المرشحين المطلوبين أو عدم إرجاع أي مرشح على الإطلاق - وعدم عرض أي مرشحين فقط في حال وجود خطأ في الطلب (يُرجى الاطّلاع على promptFeedback) - يتم الإبلاغ عن الملاحظات بشأن كل مرشّح في finishReason وsafetyRatings.

تمثيل JSON
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  },
  "usageMetadata": {
    object (UsageMetadata)
  }
}
الحقول
candidates[]

object (Candidate)

ردود المرشح من النموذج.

promptFeedback

object (PromptFeedback)

عرض ملاحظات عن الطلب ذات صلة بفلاتر المحتوى

usageMetadata

object (UsageMetadata)

النتائج فقط. البيانات الوصفية حول استخدام الرمز المميّز لطلبات الإنشاء

PromptFeedback

مجموعة من البيانات الوصفية للملاحظات التي تم تحديدها في GenerateContentRequest.content

تمثيل JSON
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
الحقول
blockReason

enum (BlockReason)

اختياريّ. وفي حال ضبطها، يتم حظر الطلب ولا يتم عرض أي مرشح. أعِد صياغة طلبك.

safetyRatings[]

object (SafetyRating)

تقييمات لسلامة رسالة الطلب يجب توفير تقييم واحد كحدّ أقصى لكل فئة.

BlockReason

يحدِّد سبب حظر الطلب.

عمليات التعداد
BLOCK_REASON_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدمة.
SAFETY تم حظر الطلب لأسباب تتعلق بالسلامة. يمكنك فحص "safetyRatings" لمعرفة فئة الأمان التي حظرتها.
OTHER تم حظر الطلب بسبب أسباب غير معروفة.

UsageMetadata

البيانات الوصفية حول استخدام الرمز المميّز لطلب الإنشاء

تمثيل JSON
{
  "promptTokenCount": integer,
  "candidatesTokenCount": integer,
  "totalTokenCount": integer
}
الحقول
promptTokenCount

integer

عدد الرموز المميّزة في الطلب

candidatesTokenCount

integer

إجمالي عدد الرموز المميّزة بين الاقتراحات التي تم إنشاؤها

totalTokenCount

integer

إجمالي عدد الرموز المميّزة لطلب الإنشاء (الطلب + المرشّحون)