الانتقال إلى المحتوى الرئيسي
GET
استرجاع عملية إنشاء
استدعِ GET /v1/generations?id=<request_id> لجلب سجل التدقيق المخزّن لطلب في مساحة عملك. يحتاج إلى النطاق generations:read؛ وغياب id يُرجع 400 ‏missing_id. تتلقى الطلبات الجديدة معرّف توليد G- يُنشئه الخادم، ويُعاد في ترويسة الاستجابة x-request-id وفي استجابة التوليد. استخدم هذا المعرّف لسجلات الطلبات والبحث عن عمليات التوليد والدعم. لا تحل قيمة x-request-id التي يقدّمها المتصل محل معرّف التوليد. ولا تزال معرّفات السجلات القديمة بتنسيق UUID تعمل في البحث.

أعد تشغيل طلب

تتضمن كل استجابة replay_supported. عندما يكون تسجيل الإدخال والإخراج قد خزّن جسم الطلب ويُسمح لك بقراءة المحتويات المخزّنة، تكون قيمة replay_supported هي true ويحتوي replay_request على الجسم الذي ترسله مجددًا لإعادة تشغيل مضبوطة:
1

اقرأ عملية التوليد

استدعِ GET /v1/generations?id=<request_id>.
2

تحقق من إمكانية إعادة تشغيله

تابع فقط إذا كانت قيمة replay_supported هي true.
3

أرسله مجددًا

أرسل replay_request إلى نقطة النهاية المذكورة في endpoint، مثل /v1/chat/completions أو /v1/responses.
يمكن لمساحة العمل أن تقصر المحتويات المخزّنة على المالكين والمسؤولين. عندها يحصل المتصلون الآخرون، بمن فيهم مفاتيح API التي أنشأها الأعضاء، على replay_request: null وعلى تفاصيل الطلب بدون محتوياته.

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

معلمات الاستعلام

id
string
مطلوب

معرّف عملية الإنشاء

الاستجابة

بيانات عملية الإنشاء

created_at
string<date-time>
request_id
string

معرّف إنشاء عام. تستخدم عمليات الإنشاء الجديدة التنسيق G-؛ وقد تحتوي السجلات التاريخية على معرّفات سابقة، بما فيها UUID.

team_id
string
app_id
string | null
endpoint
string
model_id
string
provider
string
native_response_id
string | null
stream
boolean
byok
boolean
status_code
number
success
boolean
error_code
string | null
error_message
string | null
latency_ms
number
generation_ms
number
usage
object | null
cost_nanos
number
currency
string
pricing_lines
object[]
key_id
string
throughput
number | null
replay_supported
boolean

يوضح ما إذا كانت حمولة طلب قابلة لإعادة التشغيل متاحة لعملية الإنشاء هذه.

replay_request
object | null

حمولة الطلب القابلة لإعادة التشغيل التي تم التقاطها لعملية الإنشاء هذه عند توفرها.

آخر تعديل في ١٦ نوفمبر ٢٠٢٦