النص

استرجاع الاستجابة

يسترجع استجابة مخزنة بواسطة المعرف (ID)، أو يقوم بعملية استطلاع (polling) لاستجابة في الخلفية.

GET
/v1/responses/{id}

نظرة عامة

يعيد استجابة تم إنشاؤها بواسطة إنشاء استجابة. استخدمه لاستطلاع استجابة 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
curl -X GET "https://api.tokenlab.sh/v1/responses/resp_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

الاستجابة

200 OK
{
  "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
  }
}

الأخطاء

الحالةالرمزالمعنى
404response_not_foundالمعرف (ID) غير معروف، أو ينتمي لحساب آخر، أو تم حذفه، أو تم إنشاؤه مع store: false، أو تجاوز فترة الاحتفاظ الخاصة به.
502upstream_response_read_failedلم تتمكن TokenLab من قراءة الاستجابة من الخدمة التي أنتجتها. حاول مرة أخرى لاحقاً.
503response_state_unavailable, response_result_unavailableحالة الاستجابة غير متاحة مؤقتاً. حاول مرة أخرى لاحقاً.

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

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

id*string

معرف الاستجابة الذي تم إرجاعه بواسطة POST /v1/responses.

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

include?array<string>

حقول رد إضافية ليتم تضمينها، يتم إعادة توجيهها حيثما يدعمها النموذج.

include_obfuscation?boolean

ما إذا كانت الأحداث المتدفقة تتضمن حقول تعمية (obfuscation)، يتم إعادة توجيهها حيثما يدعمها النموذج.

stream?boolean

ما إذا كان سيتم استرجاع الرد كدفق أحداث. ينطبق أثناء استمرار تشغيل الرد؛ يتم إرجاع الرد المنتهي بتنسيق JSON.

starting_after?integer

رقم التسلسل الذي يتم بعده إرجاع أحداث البث. ينطبق فقط مع stream.

الاستجابة

application/json

application/json

application/json

application/json