واجهة API لـ Gemini 3.5 Flash

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

متغيرات النموذج

تدعم واجهة API هذه ثلاثة متغيرات من نموذج Gemini 3.5 Flash:

مقارنة سريعة

Gemini 3.5 Flash نص إلى نص

نقطة النهاية

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.5-flash-text-to-text',
    messages: [
      {
        role: 'user',
        content: 'Write a concise summary of how transformer models work.'
      }
    ],
    stream: true,
    max_tokens: 2048
  })
});

Gemini 3.5 Flash صورة إلى نص

نقطة النهاية

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.5-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.5 Flash تحليل الملفات

نقطة النهاية

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.5-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
  })
});

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

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

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

textنسخ
data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"gemini-3.5-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.5-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.5-flash-text-to-text","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"gemini-3.5-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[] بدلاً من تسطيح السياق في prompt واحد.
2. اختر متغير النموذج المناسب: استخدم Text to Text للمهام النصية فقط، وImage to Text لفهم الصور، وFile Analysis عند الحاجة إلى مستندات أو محتوى مختلط.
3. استهلك أحداث SSE: أضف choices[0].delta.content للعرض المتدفق وتعامل مع data: [DONE] كاكتمال ناجح.
4. أرسل المدخلات المدعومة فقط: تتجاهل نماذج النص أجزاء الملفات والصور غير المدعومة في العميل الحالي.