مرجع OpenAI Responses لنماذج GPT وClaude
مرجع صيغة OpenAI Responses لنماذج GPT وClaude، وأثر كل معامل هنا، والأدوات، والإخراج المنظّم، والتفكير، والبث، والأخطاء.
في هذه الصفحة
صيغة OpenAI الأحدث: طلب واحد فيه input، ورد مكوّن من عناصر مثل النص واستدعاءات الدوال. تعمل مع نماذج GPT وClaude. أما نماذج Gemini فلا تعمل على هذا العنوان، فاستخدم معها Chat Completions أو Messages أو generateContent.
https:/ / 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، فلا يظهر في الكود.
المعاملات#
يبيّن كل صف ما يحدث للمعامل مع كل عائلة نماذج: مدعوم أي أننا نمرّره إلى النموذج؛ ويُتجاهل أي أن الطلب يُقبل لكن المعامل بلا أثر، فلا تعتمد عليه؛ ويُرفض أي أن الطلب يفشل. قسنا هذه الحالات على البوابة نفسها.
inputstring | arrayمطلوبنص واحد، أو قائمة رسائل وأجزاء منها الصور ونتائج الدوال.ClaudeمدعومGPTمدعومGeminiيُرفضinstructionsstringتعليمات النظام للنموذج.ClaudeمدعومGPTمدعومGeminiيُرفضmax_output_tokensintegerأقصى عدد من توكنات الإخراج.ClaudeمدعومGPTيُتجاهلGeminiيُرفضtemperaturenumberدرجة العشوائية في الرد.ClaudeمدعومGPTيُتجاهلGeminiيُرفضtop_pnumberأخذ العينات من الاحتمالات الأعلى فقط.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 تعمل هنا أيضًا، وتجدها في قائمة النماذج.
هل كانت هذه الصفحة مفيدة؟