文字
擷取回應
透過 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 -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 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