واجهة API لـ Gemini 3.6 Flash

مرجع API كامل لنماذج Gemini 3.6 Flash اللغوية الكبيرة المقدمة من Google.

إصدارات النموذج

تدعم واجهة API هذه ثلاثة إصدارات من نموذج Gemini 3.6 Flash:

مقارنة سريعة

Gemini 3.6 Flash Text to Text

نقطة النهاية

httpنسخ
POST /api/v1/chat/completions

معلمات الطلب

مطلوبة

دعم الرسائل

اختيارية

مثال على الطلب

javascriptنسخ
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'text/event-stream',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-3.6-flash-text-to-text',
    messages: [
      {
        role: 'user',
        content: 'Write a concise summary of how transformer models work.'
      }
    ],
    stream: true,
    max_tokens: 2048
  })
});

Gemini 3.6 Flash Image to Text

نقطة النهاية

httpنسخ
POST /api/v1/chat/completions

معلمات الطلب

مطلوبة

دعم الرسائل

اختيارية

مثال على الطلب

javascriptنسخ
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'text/event-stream',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-3.6-flash-image-to-text',
    messages: [
      {
        role: 'user',
        content: [
          { type: 'text', text: 'Describe the image and extract any visible text.' },
          {
            type: 'image_url',
            image_url: {
              url: 'https://example.com/sample-image.jpg'
            }
          }
        ]
      }
    ],
    stream: true,
    max_tokens: 2048
  })
});

Gemini 3.6 Flash File Analysis

نقطة النهاية

httpنسخ
POST /api/v1/chat/completions

معلمات الطلب

مطلوبة

دعم الرسائل

اختيارية

مثال على الطلب

javascriptنسخ
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'text/event-stream',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-3.6-flash-file-analysis',
    messages: [
      {
        role: 'user',
        content: [
          { type: 'text', text: 'Summarize this file and extract the key risks.' },
          {
            type: 'file',
            file: {
              filename: 'demo.pdf',
              file_data: 'https://example.com/demo.pdf'
            }
          }
        ]
      }
    ],
    stream: true,
    max_tokens: 4096
  })
});

تنسيق الاستجابة

تعيد نماذج Gemini 3.6 Flash اللغوية الكبيرة استجابات completion متوافقة مع OpenAI. عند استخدام stream: true تكون الاستجابة Server-Sent Events؛ وعند استخدام stream: false تكون الاستجابة كائن JSON واحدًا.

استجابة ناجحة

textنسخ
data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"gemini-3.6-flash-text-to-text","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"gemini-3.6-flash-text-to-text","choices":[{"index":0,"delta":{"content":"Here is a concise summary"},"finish_reason":null}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"gemini-3.6-flash-text-to-text","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"gemini-3.6-flash-text-to-text","choices":[],"usage":{"prompt_tokens":12,"completion_tokens":8,"total_tokens":20}}

data: [DONE]

استجابة خطأ

textنسخ
event: error
data: {"error":{"message":"API requests too frequent, exceeding rate limit","type":"rate_limit_error","code":"1302","param":null}}

أفضل الممارسات

1. استخدم رسائل منظّمة: أرسل سجل المحادثة عبر messages[] بدلًا من دمج السياق في مطالبة واحدة.
2. اختر إصدار النموذج المناسب: استخدم Text to Text للمهام النصية فقط، وImage to Text لفهم الصور، وFile Analysis عند الحاجة إلى مستندات أو محتوى مختلط.
3. استهلك أحداث SSE: ألحق choices[0].delta.content للعرض المتدفق وتعامل مع data: [DONE] على أنه اكتمال ناجح.
4. أرسل المدخلات المدعومة فقط: تتجاهل النماذج النصية أجزاء الملفات والصور غير المدعومة في العميل الحالي.