跳转到主要内容
GET
获取生成记录
调用 GET /v1/generations?id=<request_id>,获取你工作区中某个请求已存储的审计记录。它需要 generations:read 范围;缺少 id 会返回 400 missing_id。 新请求会获得服务器生成的 G- 生成 ID,通过 x-request-id 响应标头和生成响应返回。请使用此 ID 查询请求日志、查找生成记录和联系支持。调用方提供的 x-request-id 不会替换生成 ID。旧的 UUID 日志 ID 仍可用于查找。

重放请求

每个响应都包含 replay_supported。当 I/O 日志存储了请求正文,且你有权读取存储的内容时,replay_supported 为 true,replay_request 中保存着可发回以受控重新运行的正文:
1

读取生成记录

调用 GET /v1/generations?id=<request_id>。
2

确认可以重放

只有在 replay_supported 为 true 时才继续。
3

再次发送

将 replay_request 发送到 endpoint 中指定的端点,例如 /v1/chat/completions 或 /v1/responses。
工作区可以将存储的内容限制为仅所有者和管理员可见。此时其他调用方(包括成员创建的 API 密钥)会得到 replay_request: null,以及不含内容的请求详情。

授权

Authorization
string
header
必填

Bearer 令牌身份验证

查询参数

id
string
必填

生成记录 ID

响应

生成记录数据

created_at
string<date-time>
request_id
string

公开生成标识符。新的生成使用 G- 格式;历史日志可能包含 UUID 等旧标识符。

team_id
string
app_id
string | null
endpoint
string
model_id
string
provider
string
native_response_id
string | null
stream
boolean
byok
boolean
status_code
number
success
boolean
error_code
string | null
error_message
string | null
latency_ms
number
generation_ms
number
usage
object | null
cost_nanos
number
currency
string
pricing_lines
object[]
key_id
string
throughput
number | null
replay_supported
boolean

指示此生成是否提供可重放的请求负载。

replay_request
object | null

此生成的可重放请求负载(如有)。

最后修改于 2026年11月16日