Skip to main content

概述

每次 API 请求,平台都会自动生成一个唯一的 请求 ID,贯穿整个调用链路。该机制适用于 所有 API 接口,包括 Chat、图像生成、视频生成、音频、Embeddings、Rerank 等。
无需额外配置,请求 ID 会自动包含在每个 API 响应中。

响应头说明

每次 API 调用的响应中会包含以下 Header:

错误响应中的请求 ID

当请求失败时,响应体的 JSON 中也会包含请求 ID:

如何获取请求 ID

通过 curl

响应头中可以看到:

Python

Node.js

使用场景

提交工单

遇到问题时,将平台请求 ID 附在工单中,可大幅加速排查效率。

上游追溯

需要向上游供应商反馈问题时,提供 X-Upstream-Request-Id 作为追溯依据。

程序化处理

在代码中捕获请求 ID,写入自己的日志系统,实现端到端链路追踪。
建议在生产环境中记录每次 API 调用的请求 ID,便于事后排查。