مرجع Chat Completions المتوافق مع OpenAI
مرجع صيغة Chat Completions المتوافقة مع OpenAI، وأثر كل معامل مع نماذج Claude وGPT وGemini، والبث، والأمثلة، والأخطاء.
في هذه الصفحة
أرسل محادثة واحصل على رد النموذج. هذه الصيغة تعمل مع نماذج Claude وGPT وGemini، فيكفي أن تغيّر model لتنتقل بينها.
https:/ / api.5abeer.ai/ v1/ chat/ completionsالمصادقة#
أرسل مفتاحك في الترويسة Authorization بكلمة Bearer يليها المفتاح. يعمل المفتاح مع نماذج المزوّد الذي أنشأته له، والتفاصيل في المفاتيح والمصادقة. العنوان الأساسي لهذه الصيغة:
https://api.5abeer.ai/v1Authorization: Bearer <KEY>https://api.5abeer.aix-api-key: <KEY>https://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، فلا يظهر في الكود.
المعاملات#
يبيّن كل صف ما يحدث للمعامل مع كل عائلة نماذج: مدعوم أي أننا نمرّره إلى النموذج؛ ويُتجاهل أي أن الطلب يُقبل لكن المعامل بلا أثر، فلا تعتمد عليه؛ ويُرفض أي أن الطلب يفشل. قسنا هذه الحالات على البوابة نفسها، ولم ننقلها من وثائق المزوّد.
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يُتجاهل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؛ الرد يوضح الشكل، والنص فيه مثال.
الأخطاء#
أخطاء المفتاح والرصيد والحدود تصلك قبل استدعاء أي نموذج، والباقي يأتي أثناء تنفيذ الطلب. أكثرها شيوعًا:
invalid_request_error: الطلب ناقص أو فيه قيمة غير صحيحة، مثل غيابmodel.INVALID_API_KEY: المفتاح غير صحيح.MODEL_PLATFORM_NOT_ALLOWED: المفتاح لمزوّد غير مزوّد النموذج.INSUFFICIENT_BALANCE: الرصيد لا يكفي للطلب.USAGE_LIMIT_EXCEEDED: بلغ الاشتراك حد الساعات الخمس أو الحد الأسبوعي.RATE_LIMITED: طلبات كثيرة في وقت قصير.
أشكال الأخطاء والرموز التي تظهر أثناء تنفيذ الطلب، مثل 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.
كل النماذج والأسعارهل كانت هذه الصفحة مفيدة؟