> ## Documentation Index
> Fetch the complete documentation index at: https://docs-vip.apigo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 请求 ID

> 使用 x-apigo-request-id 关联客户端请求、ApiGo 调用记录与排障信息。

对于每个生成用量记录的模型请求，ApiGo 都会在响应头中返回 `x-apigo-request-id`。这个 ID 用于关联响应与 ApiGo 中的对应请求记录。

当响应包含该 header 时，请将它与你自己的请求数据和日志一起保存。后续可以使用这个 ID 查找对应的用量记录，或协助 ApiGo 支持团队定位问题。

## 读取请求 ID

请求 ID 位于 HTTP 响应头中：

```http theme={null}
HTTP/1.1 200 OK
content-type: application/json
x-apigo-request-id: 2012345678901234567
```

建议同时记录以下信息：

* 你的业务请求 ID
* `x-apigo-request-id`
* 请求时间和 endpoint
* HTTP 状态码

## 流式请求

流式请求会在数据流开始之前发送 HTTP 响应头。如果响应包含 `x-apigo-request-id`，请在读取 SSE 事件时保留这个值，并将它与整条数据流关联。

## 使用建议

* 将请求 ID 作为不透明字符串保存。不要将它转换为 JavaScript `Number`。
* 不要解析请求 ID、根据其格式编写逻辑，或自行生成这个值。
* 不要使用请求 ID 判断调用成功或失败。请使用 HTTP 状态码和响应内容。
* 如果需要联系支持团队，请同时提供请求 ID、请求时间、endpoint 和 HTTP 状态码。

在 ApiGo 创建用量记录之前被拒绝的请求不适用上述保证，包括部分网关级错误和早期校验错误。客户端不应将缺少请求 ID 本身视为新的请求错误。