النص
استرجاع الاستجابة
يسترجع استجابة مخزنة بواسطة المعرف (ID)، أو يقوم بعملية استطلاع (polling) لاستجابة في الخلفية.
نظرة عامة
يعيد استجابة تم إنشاؤها بواسطة إنشاء استجابة. استخدمه لاستطلاع استجابة background حتى تصبح حالتها status نهائية، أو لقراءة استجابة مخزنة مرة أخرى.
- أي الاستجابات: الاستجابات التي تم إنشاؤها مع ضبط
storeعلى غيرfalse، واستجاباتbackground. عند ضبطstore: falseلا تحتفظ TokenLab بأي شيء لإرجاعه. - الاحتفاظ: تحتفظ TokenLab بالاستجابة المخزنة لمدة 24 ساعة. قد تظل بعض الاستجابات قابلة للاسترجاع لمدة تصل إلى 30 يوماً، ولكن لا تعتمد على ذلك: احفظ النتيجة التي تحتاجها. بعد انتهاء فترة الاحتفاظ، سيعيد المعرف (ID) الخطأ
404. - الملكية: يمكنك فقط قراءة الاستجابات التي تم إنشاؤها في حسابك الخاص. المعرف (ID) الخاص بحساب آخر سيعيد
404، تماماً مثل المعرف غير المعروف. - الحالة:
queued،in_progress،completed،incomplete،failed، أوcancelled. تحقق منstatus، وليس فقط رمز HTTP.
ينطبق كل من stream و starting_after أثناء استمرار تشغيل الاستجابة. يتم إرجاع الاستجابة المنتهية بتنسيق JSON. يتم تمرير include و include_obfuscation في حال كان النموذج يدعمها.
الطلب
curl -X GET "https://api.tokenlab.sh/v1/responses/resp_abc123" \
-H "Authorization: Bearer sk-your-api-key"الاستجابة
{
"id": "resp_abc123",
"object": "response",
"created_at": 1706000000,
"status": "completed",
"model": "gpt-5.6-terra",
"output": [
{
"id": "msg_abc123",
"type": "message",
"status": "completed",
"role": "assistant",
"content": [
{"type": "output_text", "text": "Hello! How can I help you today?", "annotations": []}
]
}
],
"usage": {
"input_tokens": 10,
"output_tokens": 12,
"total_tokens": 22
}
}الأخطاء
| الحالة | الرمز | المعنى |
|---|---|---|
404 | response_not_found | المعرف (ID) غير معروف، أو ينتمي لحساب آخر، أو تم حذفه، أو تم إنشاؤه مع store: false، أو تجاوز فترة الاحتفاظ الخاصة به. |
502 | upstream_response_read_failed | لم تتمكن TokenLab من قراءة الاستجابة من الخدمة التي أنتجتها. حاول مرة أخرى لاحقاً. |
503 | response_state_unavailable, response_result_unavailable | حالة الاستجابة غير متاحة مؤقتاً. حاول مرة أخرى لاحقاً. |
التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات المسار
معرف الاستجابة الذي تم إرجاعه بواسطة POST /v1/responses.
معاملات الاستعلام
حقول رد إضافية ليتم تضمينها، يتم إعادة توجيهها حيثما يدعمها النموذج.
ما إذا كانت الأحداث المتدفقة تتضمن حقول تعمية (obfuscation)، يتم إعادة توجيهها حيثما يدعمها النموذج.
ما إذا كان سيتم استرجاع الرد كدفق أحداث. ينطبق أثناء استمرار تشغيل الرد؛ يتم إرجاع الرد المنتهي بتنسيق JSON.
رقم التسلسل الذي يتم بعده إرجاع أحداث البث. ينطبق فقط مع stream.
الاستجابة
application/json
application/json
application/json
application/json