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

مرجع OpenAI Responses لنماذج GPT وClaude

مرجع صيغة OpenAI Responses لنماذج GPT وClaude، وأثر كل معامل هنا، والأدوات، والإخراج المنظّم، والتفكير، والبث، والأخطاء.

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

صيغة OpenAI الأحدث: طلب واحد فيه input، ورد مكوّن من عناصر مثل النص واستدعاءات الدوال. تعمل مع نماذج GPT وClaude. أما نماذج Gemini فلا تعمل على هذا العنوان، فاستخدم معها Chat Completions أو Messages أو generateContent.

POSThttps://api.5abeer.ai/v1/responses

المصادقة#

أرسل مفتاحك في الترويسة Authorization بكلمة Bearer يليها المفتاح، مع العنوان الأساسي المتوافق مع OpenAI. مكتبات OpenAI الرسمية تستدعي هذا العنوان عبر client.responses.create، والتفاصيل في العناوين الأساسية.

مثال سريع#

curl --request POST "https://api.5abeer.ai/v1/responses" \
  --header "Authorization: Bearer $KHABEER_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"model":"claude-sonnet-5.5","input":"اكتب فكرة منتج في سطر واحد"}'
الرد
{
  "id": "resp_68c1",
  "object": "response",
  "model": "claude-sonnet-5.5",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "مرحبًا! كيف أساعدك اليوم؟"
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 21,
    "output_tokens": 12,
    "total_tokens": 33
  }
}

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

المعاملات#

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

المعاملالوصفClaudeGPTGemini
modelstringمطلوبمعرّف النموذج كما في قائمة النماذج.ClaudeمدعومGPTمدعومGeminiيُرفض
inputstring | arrayمطلوبنص واحد، أو قائمة رسائل وأجزاء منها الصور ونتائج الدوال.ClaudeمدعومGPTمدعومGeminiيُرفض
instructionsstringتعليمات النظام للنموذج.ClaudeمدعومGPTمدعومGeminiيُرفض
max_output_tokensintegerأقصى عدد من توكنات الإخراج.ClaudeمدعومGPTيُتجاهلGeminiيُرفض
temperaturenumberدرجة العشوائية في الرد.ClaudeمدعومGPTيُتجاهلGeminiيُرفض
top_pnumberأخذ العينات من الاحتمالات الأعلى فقط.ClaudeمدعومGPTيُتجاهلGeminiيُرفض
streambooleanأرسل الرد أحداثًا متتابعة. التفاصيل في البث المتدفق.ClaudeمدعومGPTمدعومGeminiيُرفض
toolsarrayالدوال التي يستطيع النموذج استدعاءها.ClaudeمدعومGPTمدعومGeminiيُرفض
tool_choicestring | objectauto أو none أو required أو دالة بعينها.ClaudeمدعومGPTمدعومGeminiيُرفض
parallel_tool_callsbooleanاسمح بأكثر من استدعاء في الرد نفسه أو امنعه.ClaudeيُتجاهلGPTمدعومGeminiيُرفض
textobjectformat لإخراج منظّم بمخطط json_schema. لنماذج Claude استخدم أداة بمخطط.ClaudeيُتجاهلGPTمدعومGeminiيُرفض
reasoningobjecteffort لعمق التفكير: low أو medium أو high.ClaudeمدعومGPTمدعومGeminiيُرفض
includearrayحقول إضافية في الرد، مثل reasoning.encrypted_content.ClaudeيُتجاهلGPTمدعومGeminiيُرفض
prompt_cache_keystringمفتاح ثابت يجمع الطلبات المتشابهة في التخزين المؤقت.ClaudeيُتجاهلGPTمدعومGeminiيُرفض
previous_response_idstringلا أثر لهذا الحقل هنا. أرسل المحادثة كاملة في input في كل طلب.ClaudeيُتجاهلGPTيُتجاهلGeminiيُرفض
storebooleanلا أثر لهذا الحقل هنا.ClaudeيُتجاهلGPTيُتجاهلGeminiيُرفض
truncationstringقص المحادثة الطويلة تلقائيًا.ClaudeيُتجاهلGPTيُتجاهلGeminiيُرفض
metadataobjectقيم خاصة بك تُرفق بالطلب.ClaudeيُتجاهلGPTيُتجاهلGeminiيُرفض
userstringمعرّف للمستخدم النهائي في نظامك.ClaudeيُتجاهلGPTيُتجاهلGeminiيُرفض

المحادثات#

كل طلب مستقل بذاته: لا أثر هنا لـ previous_response_id ولا لـ store. لتكمل محادثة أرسلها كاملة في input في كل مرة، رسائلك بالدور user وردود النموذج بالدور assistant، كما في مثال المحادثة الكاملة.

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

أضف جزءًا من نوع input_image إلى رسالة user، وقيمة image_url فيه رابط data: بترميز Base64 أو رابط عام يبدأ بـ https، بجانب جزء input_text.

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

مع "stream": true يصلك الرد أحداثًا مسمّاة: response.created، ثم response.output_text.delta بالنص على أجزاء، ثم response.completed بالرد الكامل وusage. إذا فشل الطلب في منتصفه يصلك response.failed ومعه رمز الخطأ. التفاصيل في البث المتدفق.

أمثلة#

بث متدفق#

curl -N https://api.5abeer.ai/v1/responses \
  -H "Authorization: Bearer $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "Write a product idea in one sentence.",
    "stream": true
  }'
أحداث البث
event: response.created
data: {"type":"response.created","response":{"id":"resp_p8a01","object":"response","status":"in_progress","model":"gpt-5.6-sol"}}

event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_p8a01","output_index":0,"content_index":0,"delta":"Lumen Notes: "}

event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_p8a01","output_index":0,"content_index":0,"delta":"a notebook that turns voice memos "}

event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_p8a01","output_index":0,"content_index":0,"delta":"into tidy to-do lists."}

event: response.completed
data: {"type":"response.completed","response":{"id":"resp_p8a01","object":"response","created_at":1790000000,"status":"completed","model":"gpt-5.6-sol","output":[{"type":"message","id":"msg_p8a01","role":"assistant","status":"completed","content":[{"type":"output_text","text":"Lumen Notes: a notebook that turns voice memos into tidy to-do lists.","annotations":[]}]}],"usage":{"input_tokens":21,"output_tokens":18,"total_tokens":39}}}

محادثة كاملة مع تعليمات#

curl https://api.5abeer.ai/v1/responses \
  -H "Authorization: Bearer $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "instructions": "Answer in one sentence.",
    "input": [
      {
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "Suggest a product name."
          }
        ]
      },
      {
        "role": "assistant",
        "content": [
          {
            "type": "output_text",
            "text": "Lumen Notes."
          }
        ]
      },
      {
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "Now a slogan for it."
          }
        ]
      }
    ],
    "max_output_tokens": 300,
    "temperature": 0.4,
    "top_p": 0.9,
    "reasoning": {
      "effort": "low"
    }
  }'
شكل الرد
{
  "id": "resp_p8a01",
  "object": "response",
  "created_at": 1790000000,
  "status": "completed",
  "model": "claude-opus-5",
  "output": [
    {
      "type": "message",
      "id": "msg_p8a01",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "Lumen Notes: a notebook that turns voice memos into tidy to-do lists.",
          "annotations": []
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 21,
    "output_tokens": 18,
    "total_tokens": 39
  }
}

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

curl https://api.5abeer.ai/v1/responses \
  -H "Authorization: Bearer $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "What is the weather in Cairo?",
    "tools": [
      {
        "type": "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": "resp_p8a01",
  "object": "response",
  "created_at": 1790000000,
  "status": "completed",
  "model": "gpt-5.6-sol",
  "output": [
    {
      "type": "function_call",
      "id": "fc_p8a01",
      "call_id": "call_p8a01",
      "name": "get_weather",
      "arguments": "{\"city\":\"Cairo\"}",
      "status": "completed"
    }
  ],
  "usage": {
    "input_tokens": 21,
    "output_tokens": 18,
    "total_tokens": 39
  }
}

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

curl https://api.5abeer.ai/v1/responses \
  -H "Authorization: Bearer $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "Give me one product idea.",
    "text": {
      "format": {
        "type": "json_schema",
        "name": "idea",
        "strict": true,
        "schema": {
          "type": "object",
          "properties": {
            "idea": {
              "type": "string"
            }
          },
          "required": [
            "idea"
          ],
          "additionalProperties": false
        }
      }
    },
    "reasoning": {
      "effort": "low"
    },
    "include": [
      "reasoning.encrypted_content"
    ],
    "prompt_cache_key": "product-ideas-v1"
  }'
شكل الرد
{
  "id": "resp_p8a01",
  "object": "response",
  "created_at": 1790000000,
  "status": "completed",
  "model": "gpt-5.6-sol",
  "output": [
    {
      "type": "message",
      "id": "msg_p8a01",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "{\"idea\":\"Lumen Notes: a notebook that turns voice memos into tidy to-do lists.\"}",
          "annotations": []
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 21,
    "output_tokens": 18,
    "total_tokens": 39
  }
}

حقول تُقبل دون أثر#

curl https://api.5abeer.ai/v1/responses \
  -H "Authorization: Bearer $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "Write a product idea in one sentence.",
    "store": false,
    "previous_response_id": "resp_123",
    "truncation": "auto",
    "metadata": {
      "order": "42"
    },
    "user": "user-123"
  }'
شكل الرد
{
  "id": "resp_p8a01",
  "object": "response",
  "created_at": 1790000000,
  "status": "completed",
  "model": "gpt-5.6-sol",
  "output": [
    {
      "type": "message",
      "id": "msg_p8a01",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "Lumen Notes: a notebook that turns voice memos into tidy to-do lists.",
          "annotations": []
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 21,
    "output_tokens": 18,
    "total_tokens": 39
  }
}

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

الأخطاء#

الرموز الشائعة هي نفسها في Chat Completions، مع فرق واحد: حين يبلغ مفتاح الدفع حسب الاستخدام حد الإنفاق الذي وضعته، يجيب هذا العنوان بالحالة 429 والرمز insufficient_quota كما تفعل OpenAI، بدلًا من API_KEY_QUOTA_EXHAUSTED. ارفع حد المفتاح من إعداداته. باقي الأشكال والرموز في الحدود ورموز الأخطاء.

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

لكل مليون توكن
  • GPT-6.1 Solالإدخال‏30 ج.م‏الإخراج‏150 ج.م‏السياق922K
  • GPT-6 Astraالإدخال‏150 ج.م‏الإخراج‏750 ج.م‏السياق—
  • GPT-6 Solالإدخال‏30 ج.م‏الإخراج‏150 ج.م‏السياق922K
  • GPT-6 Lunaالإدخال‏1.50 ج.م‏الإخراج‏7.50 ج.م‏السياق922K
  • GPT-5.6 Lunaالإدخال‏3 ج.م‏الإخراج‏18 ج.م‏السياق400K
  • GPT-5.6 Terraالإدخال‏30 ج.م‏الإخراج‏180 ج.م‏السياق400K

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

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

نماذج Claude تعمل هنا أيضًا، وتجدها في قائمة النماذج.