文本
获取响应
按 ID 获取已保存的响应,或轮询后台响应。
概述
返回由创建响应创建的响应。可用它轮询 background 响应,直到 status 进入终态,也可用它再次读取已保存的响应。
- 适用的响应:
store未设为false的响应,以及background响应。设为store: false时,TokenLab 没有可返回的内容。 - 保留期: TokenLab 保留已保存的响应 24 小时,部分响应最长可取回 30 天,但请不要依赖这一点:需要的结果请自行保存。超过保留期后,该 ID 返回
404。 - 归属: 只能读取你自己账号下创建的响应。其他账号的 ID 与不存在的 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 AuthorizationBearer <token>
API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。
位置: 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