简短回答
排查接口问题时,先记录模型名称、接口端点和调用时间,再查看 HTTP 响应头中的x-request-id 或 request-id。如果接口返回错误响应,还要同时检查 JSON 响应体中的 request_id 等标识,并以 API易 日志中可以检索到的字段为准。
Wan 和 HappyHorse 视频接口还会在响应体中返回 request_id;响应体中的 task_id 用于查询视频任务,不等同于 Request ID。Seedance、Veo 等异步视频接口返回的 id 或 task_id 同样是视频任务 ID。
API易后台日志中的「请求 ID / 上游请求 ID / Completion ID」筛选框可以搜索用户提供的标识。打开控制台的「日志」页面后,可以按这个标识定位日志详情。
排查前先做三个动作
1
第一步:确认模型和接口端点
记录完整模型名称和实际调用地址。例如,文本模型通常调用
/v1/chat/completions,向量模型调用 /v1/embeddings,图片模型可能调用 /v1/images/generations,视频模型则可能使用 /v1/videos 或模型专用的异步端点。2
第二步:记录调用时间
记录请求发起时间,并注明时区,例如
2026-08-25 14:32 (UTC+8)。如果发生过重试,也请记录每次重试的大致时间。3
第三步:保存响应和日志信息
保存 HTTP 状态码、完整响应头、完整响应体和客户端异常。然后进入 API易控制台的「日志」页面,使用 Request ID、上游 Request ID 或 Completion ID 搜索对应记录。
不同模型的 Request ID 在哪里
如何从代码中读取
Python
cURL
使用-i 同时输出响应头和响应体,再从响应头中查找 x-request-id 或 request-id:
在控制台日志中搜索
1
打开调用日志
登录 API易控制台,进入「日志」页面,打开需要排查的日志详情。
2
填写可用的标识
在筛选框「请求 ID / 上游请求 ID / Completion ID」中粘贴用户提供的标识。优先粘贴 API易响应头中的 Request ID;如果没有,再尝试上游 Request ID 或 Completion ID。
3
核对详情
对照日志中的模型、调用时间、接口路径、渠道、HTTP 状态码、错误码和计费记录,判断请求是否到达 API易、是否进入上游,以及是否需要修改请求后重试。
为什么有时找不到 Request ID
如果请求在收到 HTTP 响应之前就失败,例如 DNS 解析失败、无法建立 TCP/TLS 连接、本地代理拒绝连接或客户端连接超时,API易还没有机会返回响应头,因此不会产生可供客户端读取的 Request ID。 这类情况请提供:- 客户端原始异常和完整堆栈;
- 请求发起时间和时区;
- 使用的模型和接口端点;
- HTTP 客户端、代理或网络环境;
- 如果同一请求曾成功或重试成功,也请提供对应的 Request ID。
联系客服时请提供什么
- Request ID;
- 上游 Request ID 或 Completion ID(如果日志中有);
- 模型名称和接口端点;
- 调用时间(注明时区);
- HTTP 状态码、完整响应体和客户端异常;
- 脱敏后的请求参数,以及控制台日志中的错误码和计费状态。
相关文档
模型调用报错怎么排查?
按错误类型、参数、分组、超时和日志记录排查接口问题
如何查看我的调用记录?
在控制台查看调用记录、错误信息和计费详情
日志查询 API
按时间、模型或 request_id 程序化查询调用日志
图片接口调用须知
了解图片请求超时、断连、计费和请求 ID 的排查方法