Skip to main content

简短回答

排查接口问题时,先记录模型名称、接口端点和调用时间,再查看 HTTP 响应头中的 x-request-idrequest-id。如果接口返回错误响应,还要同时检查 JSON 响应体中的 request_id 等标识,并以 API易 日志中可以检索到的字段为准。 Wan 和 HappyHorse 视频接口还会在响应体中返回 request_id;响应体中的 task_id 用于查询视频任务,不等同于 Request ID。Seedance、Veo 等异步视频接口返回的 idtask_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 在哪里

响应头名称不区分大小写,但字段名中的连字符不能省略:x-request-idrequest-idrequest_id 是不同写法。请同时检查响应头和错误响应体,不要只搜索其中一个名称。

如何从代码中读取

Python

cURL

使用 -i 同时输出响应头和响应体,再从响应头中查找 x-request-idrequest-id
对于 Wan 或 HappyHorse 视频,还要保存响应体中的两个字段:

在控制台日志中搜索

1

打开调用日志

登录 API易控制台,进入「日志」页面,打开需要排查的日志详情。
2

填写可用的标识

在筛选框「请求 ID / 上游请求 ID / Completion ID」中粘贴用户提供的标识。优先粘贴 API易响应头中的 Request ID;如果没有,再尝试上游 Request ID 或 Completion ID。
3

核对详情

对照日志中的模型、调用时间、接口路径、渠道、HTTP 状态码、错误码和计费记录,判断请求是否到达 API易、是否进入上游,以及是否需要修改请求后重试。
用户只提供「大概几点调用失败」时,仍然可以先按模型名称、调用时间和接口端点缩小范围;但如果用户能提供 Request ID,通常可以更快定位到单次调用。

为什么有时找不到 Request ID

如果请求在收到 HTTP 响应之前就失败,例如 DNS 解析失败、无法建立 TCP/TLS 连接、本地代理拒绝连接或客户端连接超时,API易还没有机会返回响应头,因此不会产生可供客户端读取的 Request ID。 这类情况请提供:
  • 客户端原始异常和完整堆栈;
  • 请求发起时间和时区;
  • 使用的模型和接口端点;
  • HTTP 客户端、代理或网络环境;
  • 如果同一请求曾成功或重试成功,也请提供对应的 Request ID。
提交排查材料时不要发送完整 API Key。请遮盖令牌中间部分,也不要直接公开包含隐私、业务数据或完整图片内容的请求体。

联系客服时请提供什么

  • Request ID;
  • 上游 Request ID 或 Completion ID(如果日志中有);
  • 模型名称和接口端点;
  • 调用时间(注明时区);
  • HTTP 状态码、完整响应体和客户端异常;
  • 脱敏后的请求参数,以及控制台日志中的错误码和计费状态。

相关文档

模型调用报错怎么排查?

按错误类型、参数、分组、超时和日志记录排查接口问题

如何查看我的调用记录?

在控制台查看调用记录、错误信息和计费详情

日志查询 API

按时间、模型或 request_id 程序化查询调用日志

图片接口调用须知

了解图片请求超时、断连、计费和请求 ID 的排查方法