TokenLab

文字

擷取回應

透過 ID 擷取已儲存的回應,或輪詢背景回應。

GET
/v1/responses/{id}

概覽

傳回由 建立回應 (Create Response) 所建立的回應。請使用此功能輪詢 background 回應直到其 status 變為最終狀態,或再次讀取已儲存的回應。

  • 哪些回應: 使用 store 未設為 false 所建立的回應,以及 background 回應。若 store: false,TokenLab 將不會保留任何內容以供傳回。
  • 保留期限: TokenLab 會將已儲存的回應保留 24 小時。部分回應最長可保留 30 天,但請勿依賴此機制:請務必儲存您需要的結果。超過保留期限後,該 ID 將傳回 404。
  • 所有權: 您僅能讀取在您帳戶中建立的回應。來自其他帳戶的 ID 將傳回 404,與未知 ID 的結果相同。
  • 狀態: 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_foundID 未知、屬於其他帳戶、已被刪除、建立時設定為 store: false,或已超過保留期限。
502upstream_response_read_failedTokenLab 無法從產生該回應的服務讀取回應。請稍後重試。
503response_state_unavailable, response_result_unavailable回應狀態暫時不可用。請稍後重試。

授權

BearerAuth
AuthorizationBearer <token>

API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。

位置: header

路徑參數

id*string

由 POST /v1/responses 傳回的回應 ID。

查詢參數

include?array<string>

要包含的額外回應欄位,將在模型支援的情況下轉發。

include_obfuscation?boolean

串流事件是否包含混淆欄位,將在模型支援的情況下轉發。

stream?boolean

是否將回應作為事件串流檢索。適用於回應仍在執行時;已完成的回應將以 JSON 格式回傳。

starting_after?integer

串流事件回傳後的序列號。僅適用於 stream 為 true 時。

回應

application/json

application/json

application/json

application/json