文本

获取响应

按 ID 获取已保存的响应,或轮询后台响应。

GET
/v1/responses/{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
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 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