概述
每次 API 请求,平台都会为本次调用分配一个 请求 ID,用于追踪 API 调用、排查问题与提交工单。该机制适用于 所有 API 接口,包括 Chat、图像生成、视频生成、音频、Embeddings、Rerank 等。无需额外配置,请求 ID 会自动包含在每个 API 响应中。
响应头说明
每次 API 调用的响应中会包含以下 Header:自定义请求 ID
如果你的系统已经有自己的链路追踪 ID,可以在请求头中传入:
平台会去除首尾空白;如果传入值为空或长度超过 128 字符,平台会重新生成请求 ID。
错误响应中的请求 ID
当请求失败时,响应体的 JSON 中也会包含请求 ID:如何获取请求 ID
通过 curl
Python
Node.js
使用场景
提交工单
遇到问题时,将平台请求 ID 附在工单中,可大幅加速排查效率。
链路追踪
在请求头中传入自己的追踪 ID,可将平台调用与你的内部日志关联起来。
程序化处理
在代码中捕获请求 ID,写入自己的日志系统,实现端到端链路追踪。

