استخدم GPT-5.1 Codex عبر Rivya Public API v1 مع معرف النموذج gpt-5-1-codex-chat، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والرصيد، وأمثلة الاستجابة.

متاح عبر APIإدخال النص جاهزالدردشة

معرف نموذج API

gpt-5-1-codex-chat

المدخلات

text, file

Files API

غير مطلوب للطلب الأدنى

الرصيد الأساسي

القدرة

الدردشة

الجاهزية

Chat API: غير متدفق + SSE streaming

الفوترة

TOKEN_BASED

حد prompt

20000 أحرف

عقد الطلب

ترسل طلبات Chat رسالة واحدة في كل مرة. تحفظ Rivya سجل الجلسة؛ لا ترسل مصفوفة raw messages.

المفتاح	النوع	مطلوب	الافتراضي	الوصف
model	string	نعم	gpt-5-1-codex-chat	استخدم معرف نموذج API وهو gpt-5-1-codex-chat.
session_id	string	لا	-	معرف جلسة محادثة اختياري أنشأه API. احذفه لبدء جلسة جديدة.
message	string	نعم	-	رسالة المستخدم التالية. يأتي سجل Chat API من الجلسة المحفوظة على الخادم، وليس من مصفوفة raw messages.
attachments	array	لا	-	قيم file_id اختيارية لملفات الصور التي ترجعها Files API. لا تُقبل عناوين URL الخارجية للمرفقات.
enable_web_search	boolean	لا	false	ينطبق فقط عندما يدعم نموذج Chat المحدد البحث على الويب.
reasoning_effort	string	لا	default	جهد استدلال اختياري: default أو minimal أو low أو medium أو high أو xhigh عند دعمه.
client_request_id	string	لا	-	معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

معلمات النموذج

يستخدم نموذج Chat هذا حقول Chat API المشتركة أعلاه. تظهر قدرة النموذج الخاصة على البحث في الويب ومرفقات ملفات الصور والتفكير والاستدلال ضمن بيانات الجاهزية.

الطلب الأدنى

{
  "model": "gpt-5-1-codex-chat",
  "message": "Write a concise launch plan for a new product image campaign"
}

طلب بملف مرجعي

{
  "model": "gpt-5-1-codex-chat",
  "message": "Write a concise launch plan for a new product image campaign",
  "attachments": [
    {
      "file_id": "file_uploaded_image_id"
    }
  ]
}

استجابة الإنشاء

يعيد endpoint الخاص بـ Chat رسالة assistant مكتملة، واستخدام الرموز، وتسوية الرصيد النهائية لهذا الدور.

{
  "id": "chatcmpl_msg_gpt_5_1_codex_chat_example",
  "object": "chat.completion",
  "session_id": "chat_session_gpt_5_1_codex_chat",
  "model": "gpt-5-1-codex-chat",
  "created_at": "2026-05-11T00:00:00.000Z",
  "message": {
    "id": "assistant_message_id",
    "role": "assistant",
    "content": "A concise launch plan with clear next steps."
  },
  "usage": {
    "input_tokens": 1200,
    "output_tokens": 320,
    "total_tokens": 1520
  },
  "credits": {
    "reserved": 3,
    "final": 3
  }
}

الأخطاء الشائعة

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

دمج API لنموذج GPT-5.1 Codex