انتقل إلى المحتوى

مرجع Chat Completions المتوافق مع OpenAI

مرجع صيغة Chat Completions المتوافقة مع OpenAI، وأثر كل معامل مع نماذج Claude وGPT وGemini، والبث، والأمثلة، والأخطاء.

آخر تحديث 3 أكتوبر 2026
في هذه الصفحة

أرسل محادثة واحصل على رد النموذج. هذه الصيغة تعمل مع نماذج Claude وGPT وGemini، فيكفي أن تغيّر model لتنتقل بينها.

POSThttps://api.5abeer.ai/v1/chat/completions

المصادقة#

أرسل مفتاحك في الترويسة Authorization بكلمة Bearer يليها المفتاح. يعمل المفتاح مع نماذج المزوّد الذي أنشأته له، والتفاصيل في المفاتيح والمصادقة. العنوان الأساسي لهذه الصيغة:

متوافق مع OpenAIhttps://api.5abeer.ai/v1Authorization: Bearer <KEY>
متوافق مع Anthropichttps://api.5abeer.aix-api-key: <KEY>
Geminihttps://api.5abeer.ai/v1betax-goog-api-key: <KEY>

مثال سريع#

curl --request POST "https://api.5abeer.ai/v1/chat/completions" \
  --header "Authorization: Bearer $KHABEER_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"model":"claude-sonnet-5.5","messages":[{"role":"user","content":"اكتب فكرة منتج في سطر واحد"}]}'
الرد
{
  "id": "chatcmpl-9f2",
  "object": "chat.completion",
  "model": "claude-sonnet-5.5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "مرحبًا! كيف أساعدك اليوم؟"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 12,
    "total_tokens": 33
  }
}

المفتاح يُقرأ من متغير البيئة ⁦KHABEER_API_KEY⁩، فلا يظهر في الكود.

المعاملات#

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

المعاملالوصفClaudeGPTGemini
modelstringمطلوبمعرّف النموذج كما في قائمة النماذج.ClaudeمدعومGPTمدعومGeminiمدعوم
messagesarrayمطلوبالمحادثة: رسائل بالأدوار system وuser وassistant وtool. يقبل المحتوى نصًا أو أجزاءً منها الصور.ClaudeمدعومGPTمدعومGeminiمدعوم
max_completion_tokensintegerأقصى عدد من توكنات الإخراج.ClaudeمدعومGPTيُتجاهلGeminiمدعوم
max_tokensintegerالاسم القديم لـ max_completion_tokens، ويعمل بالطريقة نفسها.ClaudeمدعومGPTيُتجاهلGeminiمدعوم
temperaturenumberدرجة العشوائية في الرد.ClaudeمدعومGPTيُتجاهلGeminiمدعوم
top_pnumberأخذ العينات من الاحتمالات الأعلى فقط.ClaudeمدعومGPTيُتجاهلGeminiمدعوم
stopstring | arrayنصوص يتوقف عندها الرد. لا تصل إلى النموذج في هذه الصيغة؛ مع نماذج Claude وGemini استخدم stop_sequences في Messages.ClaudeيُتجاهلGPTيُتجاهلGeminiيُتجاهل
streambooleanأرسل الرد أجزاءً متتابعة. التفاصيل في البث المتدفق.ClaudeمدعومGPTمدعومGeminiمدعوم
stream_optionsobjectinclude_usage لإرسال أرقام الاستخدام في آخر جزء. نماذج GPT ترسلها دائمًا.ClaudeمدعومGPTيُتجاهلGeminiمدعوم
toolsarrayالدوال التي يستطيع النموذج استدعاءها. التفاصيل في استدعاء الأدوات.ClaudeمدعومGPTمدعومGeminiمدعوم
tool_choicestring | objectauto أو none أو required أو دالة بعينها.ClaudeمدعومGPTمدعومGeminiيُتجاهل
parallel_tool_callsbooleanاسمح بأكثر من استدعاء في الرد نفسه أو امنعه.ClaudeيُتجاهلGPTمدعومGeminiيُتجاهل
response_formatobjectjson_schema أو json_object لإخراج منظّم. لنماذج Claude استخدم أداة بمخطط في Messages.ClaudeيُتجاهلGPTمدعومGeminiيُتجاهل
reasoning_effortstringعمق التفكير: low أو medium أو high.ClaudeمدعومGPTمدعومGeminiيُتجاهل
nintegerعدد الردود. يصلك رد واحد دائمًا.ClaudeيُتجاهلGPTيُتجاهلGeminiيُتجاهل
seedintegerمحاولة لتكرار النتيجة نفسها.ClaudeيُتجاهلGPTيُتجاهلGeminiيُتجاهل
presence_penaltynumberتقليل العودة إلى المواضيع نفسها.ClaudeيُتجاهلGPTيُتجاهلGeminiيُتجاهل
frequency_penaltynumberتقليل تكرار الكلمات نفسها.ClaudeيُتجاهلGPTيُتجاهلGeminiيُتجاهل
logprobsbooleanاحتمالات التوكنات في الرد. لا تُرسل.ClaudeيُتجاهلGPTيُتجاهلGeminiيُتجاهل
logit_biasobjectرفع احتمال توكنات معيّنة أو خفضه.ClaudeيُتجاهلGPTيُتجاهلGeminiيُتجاهل
userstringمعرّف للمستخدم النهائي في نظامك.ClaudeيُتجاهلGPTيُتجاهلGeminiيُتجاهل

الصور في الطلب#

ضع الصورة في قائمة content داخل رسالة user بجانب النص، إما رابط data: بترميز Base64 وإما رابطًا عامًا يبدأ بـ https. كل نموذج في القائمة أدناه يقبل الصور يقرؤها. الصورة الكبيرة تزيد حجم الطلب، والتفاصيل في الحدود.

البث المتدفق#

مع "stream": true يصلك الرد بصيغة Server-Sent Events: كل سطر data: يحمل جزءًا من نوع chat.completion.chunk فيه قطعة من النص في choices[0].delta، وينتهي البث بالسطر data: [DONE]. لتصلك أرقام الاستخدام في آخر جزء أضف "stream_options": {"include_usage": true}، أما نماذج GPT فترسلها دائمًا. التفاصيل في البث المتدفق.

أمثلة#

بث متدفق مع الاستخدام#

curl -N https://api.5abeer.ai/v1/chat/completions \
  -H "Authorization: Bearer $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "messages": [
      {
        "role": "user",
        "content": "Write a product idea in one sentence."
      }
    ],
    "stream": true,
    "stream_options": {
      "include_usage": true
    }
  }'
أحداث البث
data: {"id":"chatcmpl_p8a01","object":"chat.completion.chunk","created":1790000000,"model":"claude-opus-5","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}

data: {"id":"chatcmpl_p8a01","object":"chat.completion.chunk","created":1790000000,"model":"claude-opus-5","choices":[{"index":0,"delta":{"content":"Lumen Notes: "},"finish_reason":null}]}

data: {"id":"chatcmpl_p8a01","object":"chat.completion.chunk","created":1790000000,"model":"claude-opus-5","choices":[{"index":0,"delta":{"content":"a notebook that turns voice memos "},"finish_reason":null}]}

data: {"id":"chatcmpl_p8a01","object":"chat.completion.chunk","created":1790000000,"model":"claude-opus-5","choices":[{"index":0,"delta":{"content":"into tidy to-do lists."},"finish_reason":null}]}

data: {"id":"chatcmpl_p8a01","object":"chat.completion.chunk","created":1790000000,"model":"claude-opus-5","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: {"id":"chatcmpl_p8a01","object":"chat.completion.chunk","created":1790000000,"model":"claude-opus-5","choices":[],"usage":{"prompt_tokens":21,"completion_tokens":18,"total_tokens":39}}

data: [DONE]

استدعاء دالة#

curl https://api.5abeer.ai/v1/chat/completions \
  -H "Authorization: Bearer $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {
        "role": "user",
        "content": "What is the weather in Cairo?"
      }
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "Get the weather for a city",
          "parameters": {
            "type": "object",
            "properties": {
              "city": {
                "type": "string"
              }
            },
            "required": [
              "city"
            ]
          }
        }
      }
    ],
    "tool_choice": "auto",
    "parallel_tool_calls": false
  }'
شكل الرد
{
  "id": "chatcmpl_p8a01",
  "object": "chat.completion",
  "created": 1790000000,
  "model": "gpt-5.6-sol",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": null,
        "tool_calls": [
          {
            "id": "call_p8a01",
            "type": "function",
            "function": {
              "name": "get_weather",
              "arguments": "{\"city\":\"Cairo\"}"
            }
          }
        ]
      },
      "finish_reason": "tool_calls"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 18,
    "total_tokens": 39
  }
}

إخراج JSON بمخطط#

curl https://api.5abeer.ai/v1/chat/completions \
  -H "Authorization: Bearer $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {
        "role": "user",
        "content": "Give me one product idea."
      }
    ],
    "response_format": {
      "type": "json_schema",
      "json_schema": {
        "name": "idea",
        "strict": true,
        "schema": {
          "type": "object",
          "properties": {
            "idea": {
              "type": "string"
            }
          },
          "required": [
            "idea"
          ],
          "additionalProperties": false
        }
      }
    },
    "reasoning_effort": "low"
  }'
شكل الرد
{
  "id": "chatcmpl_p8a01",
  "object": "chat.completion",
  "created": 1790000000,
  "model": "gpt-5.6-sol",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "{\"idea\":\"Lumen Notes: a notebook that turns voice memos into tidy to-do lists.\"}"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 18,
    "total_tokens": 39
  }
}

صورة مع السؤال#

curl https://api.5abeer.ai/v1/chat/completions \
  -H "Authorization: Bearer $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_completion_tokens": 300,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "What is in this image?"
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
            }
          }
        ]
      }
    ]
  }'
شكل الرد
{
  "id": "chatcmpl_p8a01",
  "object": "chat.completion",
  "created": 1790000000,
  "model": "claude-opus-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Lumen Notes: a notebook that turns voice memos into tidy to-do lists."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 18,
    "total_tokens": 39
  }
}

إعدادات العينة#

curl https://api.5abeer.ai/v1/chat/completions \
  -H "Authorization: Bearer $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-pro",
    "messages": [
      {
        "role": "system",
        "content": "Answer in one sentence."
      },
      {
        "role": "user",
        "content": "Write a product idea."
      }
    ],
    "max_tokens": 300,
    "temperature": 0.4,
    "top_p": 0.9,
    "stop": [
      "END"
    ],
    "n": 1,
    "seed": 7,
    "presence_penalty": 0,
    "frequency_penalty": 0,
    "logprobs": false,
    "logit_bias": {},
    "user": "user-123"
  }'
شكل الرد
{
  "id": "chatcmpl_p8a01",
  "object": "chat.completion",
  "created": 1790000000,
  "model": "gemini-3.1-pro",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Lumen Notes: a notebook that turns voice memos into tidy to-do lists."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 18,
    "total_tokens": 39
  }
}

الطلب أعلاه جُرِّب على بيئة الاختبار المحلية يوم 2026-10-02؛ الرد يوضح الشكل، والنص فيه مثال.

الأخطاء#

أخطاء المفتاح والرصيد والحدود تصلك قبل استدعاء أي نموذج، والباقي يأتي أثناء تنفيذ الطلب. أكثرها شيوعًا:

أشكال الأخطاء والرموز التي تظهر أثناء تنفيذ الطلب، مثل CONTEXT_LIMIT_EXCEEDED وMODEL_UNAVAILABLE، في الحدود ورموز الأخطاء. القائمة الكاملة في الأخطاء وحلولها.

الحدود#

  • مفتاح الدفع حسب الاستخدام يحدّه رصيدك، وحد الإنفاق الذي تضعه له إن وُجد.
  • حجم الطلب وطول السياق في الحدود.

النماذج المتاحة لهذه الصيغة#

لكل مليون توكن
  • Claude Sonnet 5.5الافتراضيالإدخال‏30 ج.م‏الإخراج‏150 ج.م‏السياق1M
  • Claude Opus 5.5الإدخال‏60 ج.م‏الإخراج‏300 ج.م‏السياق1M
  • GPT-6.1 Solالإدخال‏30 ج.م‏الإخراج‏150 ج.م‏السياق922K
  • Gemini 4 Argonالإدخال‏30 ج.م‏الإخراج‏150 ج.م‏السياق—
  • Claude Fable 5.1الإدخال‏150 ج.م‏الإخراج‏750 ج.م‏السياق—
  • Claude Fable 5الإدخال‏150 ج.م‏الإخراج‏750 ج.م‏السياق1M

السعر الرسمي من صفحة المزوّد، بتاريخ 19 أكتوبر 2026.

كل النماذج والأسعار