API Hop

الوثائق

وثائق API Hop

نماذج Gemini

>-

POSThttps://api.apihop.ai/v1/chat-completions

تستخدم نماذج Gemini نقطة نهاية Chat Completions المشتركة. تسجل هذه الصفحة قيم model المدعومة وعقد المحادثة النصية.

text
POST https://api.apihop.ai/v1/chat-completions

النماذج المتاحة

قيمة modelJSON دون بثبث SSE
gemini-3.6-flashنعمنعم
gemini-3.7-flashنعمنعم
gemini-3.8-flashنعمنعم
gemini-3.5-flash-liteنعمنعم
gemini-4-argonنعمنعم

يتطلب gemini-4-argon النشر والتفعيل. إدراجه في هذا المرجع لا يؤكد الإتاحة في الإنتاج.

تميز أسماء النماذج فئات المنتجات؛ وليست اتفاقيات مستوى خدمة لزمن الاستجابة أو معدل المعالجة أو الجودة. قارن النماذج بعبء عملك الفعلي. تحقق من الإتاحة لمفتاح API لديك عبر GET https://api.apihop.ai/v1/models قبل إجراء طلب.

المصادقة

http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

طلب دون بث

json
{
  "model": "gemini-3.7-flash",
  "messages": [
    {
      "role": "system",
      "content": "You are a concise and accurate technical assistant."
    },
    {
      "role": "user",
      "content": "Explain idempotent APIs in five sentences."
    }
  ],
  "stream": false
}

طلب بث

json
{
  "model": "gemini-3.6-flash",
  "messages": [
    {
      "role": "user",
      "content": "Show a TypeScript API error-handling example."
    }
  ],
  "stream": true
}

تعيد نقطة النهاية هذه استجابة JSON كاملة واحدة افتراضيا. اضبط stream: true صراحة عندما تحتاج إلى بث SSE.

حقول الطلب

modelstringمطلوب

استخدم gemini-3.6-flash أو gemini-3.7-flash أو gemini-3.8-flash أو gemini-3.5-flash-lite أو gemini-4-argon.

messagesobject[]مطلوب

رسائل بأسلوب OpenAI Chat Completions. تتضمن كل رسالة role وcontent.

streambooleanالقيمة الافتراضية: false

تعيد true بث SSE؛ وتعيد false استجابة JSON كاملة واحدة.

max_tokensinteger

الحد الأقصى الاختياري لرموز الإخراج كعدد صحيح موجب. احذف هذا الحقل لاستخدام القيمة الافتراضية لدى المزود للنموذج المختار. بحسب النموذج، قد تشمل الميزانية رموز الاستدلال والنص النهائي معا. قد تقتطع الميزانية الصغيرة الإجابة أو تنفد قبل النص النهائي؛ وقد تزيد زيادتها التكلفة.

max_completion_tokensinteger

بديل توافق اختياري لـmax_tokens، مع اعتبارات الميزانية نفسها. يحدد النموذج المختار الدعم؛ واحذف الحقلين لاستخدام القيمة الافتراضية لدى المزود.

راجع واجهة Chat Completions المشتركة للحقول المشتركة مثل temperature وtop_p وfrequency_penalty وpresence_penalty وstop وn. يعتمد دعم الحقول الاختيارية وسلوكها على النموذج المختار؛ ولا تضمن هذه الصفحة كل حقل مشترك.

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

json
{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "gemini-3.7-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "An idempotent API produces the same effective result when..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 26,
    "completion_tokens": 118,
    "total_tokens": 144
  }
}

قد تتضمن usage تفاصيل اختيارية لرموز الاستدلال؛ وينبغي للعملاء استيعاب غيابها أو تغيرها بحسب النموذج.

ملاحظات الاستخدام

  • يجب أن تكون قيمة model في جسم الطلب أحد معرفات النماذج العامة المدرجة في جدول النماذج المتاحة.
  • لا تقبل أسماء المنتجات أو أسماء العرض أو الأسماء البديلة الأخرى بدلا من معرف نموذج عام.
  • تنطبق هذه الصفحة فقط على طلبات Chat Completions المرسلة إلى POST https://api.apihop.ai/v1/chat-completions، وليس OpenAI Responses أو Claude Messages.
  • استخدم GET https://api.apihop.ai/v1/models للنماذج الظاهرة لمفتاح API الحالي، واستخدم وحدة التحكم للأسعار الحالية.