Gemini الأصلي

بث توليد المحتوى

بث عملية توليد المحتوى باستخدام تنسيق Google Gemini API

POST
/v1beta/models/{model}:streamGenerateContent

إصدار SSE من generateContent الخاص بـ Gemini. قد تحتوي الأحداث على بيانات وصفية فقط أو محتوى وسيط بدون finishReason. ينتهي البث عند EOF الطبيعي ولا يُلحق علامة [DONE].

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

modelstringpathمطلوب

اسم النموذج (مثل gemini-2.5-pro، gemini-3.5-flash).

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

keystringquery

مفتاح API (بديل للمصادقة عبر الترويسة).

المصادقة

مماثلة لـ توليد المحتوى: ?key=، أو x-goog-api-key، أو Authorization: Bearer.

نص الطلب

مماثل لـ توليد المحتوى. يتضمن ذلك مصفوفات parts متعددة الوسائط مع أجزاء صور inline_data مهيكلة لطلبات الرؤية.

يعتمد دعم generationConfig.candidateCount، والأدوات، وأنواع الوسائط، والحقول الاختيارية الأخرى على النموذج المحدد.

الاستجابة

يُرجع أحداث Server-Sent Events الخاصة بـ Gemini. تُعد الأحداث المقتصرة على البيانات الوصفية فقط، والأجزاء الوسيطة بدون finishReason، وEOF الطبيعي صالحة. لا يُلحق البث علامة [DONE] الخاصة بـ Chat Completions. يمثل كل حدث سطر data: يحتوي على جزء JSON واحد. تكون الاستجابة دائمًا بتنسيق SSE؛ ويُقبل alt=sse ولكنه ليس مطلوبًا.

أي خطأ يحدث قبل الحدث الأول يُرجع خطأ Gemini بتنسيق JSON بنفس الرموز الخاصة بـ توليد المحتوى.

الطلب

curl -N -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:streamGenerateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Tell me a story"}]
      }
    ]
  }'

الاستجابة

Stream Chunk
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Once upon a time"}
        ]
      }
    }
  ]
}

مثال على مدخلات الرؤية

تستخدم طلبات الرؤية عبر البث بنية contents[].parts[] نفسها المستخدمة في نقطة النهاية غير المعتمدة على البث.

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this image." },
        {
          "inline_data": {
            "mime_type": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

التفويض

AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

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

model*string

اسم النموذج (مثال: gemini-2.5-pro)

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

key?string

مفتاح API (بديل لمصادقة الرأس)

الترويسات

X-TokenLab-Delivery-Policy?string

سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.

القيم المتاحة

  • "auto"
  • "verified"
  • "official"

جسم الطلب

application/json

طلب Gemini GenerateContent الأصلي. يتم قبول والحفاظ على كل من أسماء ProtoJSON بصيغة lowerCamelCase وأسماء proto الأصلية بصيغة snake_case، بما في ذلك الطلبات المختلطة. إذا كان كلا تهجئتي الحقل موجودتين، فإن TokenLab لا تقوم بدمجهما أو اختيار أولوية محلية. يتم إعادة توجيه الحقول غير المعروفة على أساس بذل أفضل جهد.

الاستجابة

text/event-stream

application/json

application/json

application/json

application/json

application/json