错误与处理

Echo 的 API 无法处理请求时，会返回 HTTP 状态码（表示结果的 3 位数字）和 JSON 格式的错误正文。

先确认这几点

1. 接入地址：OpenAI 格式是 https://token.echohub.io/v1，Anthropic 格式是 https://token.echohub.io。调用路径里没有 /v1 时，即使密钥正确也会返回 404（返回的不是 JSON，是网站的 HTML 页面）
2. API 密钥：在控制台的「APIキー」（API 密钥）里确认密钥没有被停用、使用上限还有剩余
3. 余额：在控制台的「残高とチャージ」（余额与充值）里确认
4. 模型 ID：确认与模型一览里的 ID 一致

错误正文的格式

按调用的端点的格式，以两种格式返回。

Anthropic 格式的示例（密钥错误时）：

{"type":"error","error":{"type":"authentication_error","message":"Invalid API key"}}

OpenAI 格式的示例（余额不足时）：

{"error":{"message":"Insufficient balance","type":"api_error","param":"","code":"insufficient_quota"}}

• 请用 HTTP 状态码，以及 error.type（Anthropic 格式）或 error.code（OpenAI 格式）判断错误的种类。message 的文字可能会变，不要用它来做程序的分支
• 上游 API（实际运行模型的各厂商的 API）返回的错误，message 里有时会原样放入上游的文字
• 各项目的顺序因错误而异

OpenAI 格式的 error.type，在 Echo 自己返回的错误里主要是 api_error。原样返回上游的错误时，是上游的值。在视频生成的端点（/v1/videos）里，error.type 是与 HTTP 状态码对应的值（400 是 invalid_request_error，401 是 authentication_error，403 是 permission_error，404 和 410 是 not_found_error，500 以上是 api_error）。

各种情况的原因与处理

视频生成的错误

视频生成（/v1/videos）特有的错误。步骤和各模型能用的取值见视频生成。

在提交时返回的错误不收费。生成失败的任务，查询进度时 status 是 failed，价格已全额退还。

要重试的错误

• 一边逐步延长等待时间，一边定好次数上限重试
• 有 Retry-After 头时，至少等待那么多秒。账号速率限制和上游 API 速率限制导致的 429 带 Retry-After: 60，按 IP 地址限制导致的 429 带要等待的秒数，503 带 Retry-After: 5（上游 API 那边 Echo 的账号出问题造成的 503，有时是 Retry-After: 60）
• 模型 ID 错误也以 503 返回。OpenAI 格式里 error.code 是 model_not_found。Anthropic 格式里 message 包含 does not exist or is not available
• OpenAI 和 Anthropic 的 SDK 默认会对 429 和 500 以上的错误自动重试最多 2 次。模型 ID 错误时也会重试 2 次后才报错。Claude Code 会持续重试 1 分钟以上（Claude Code）

流式输出中途停止时

流式输出（一点一点接收回答的方式）会先返回 HTTP 200，再发送回答。之后上游 API 返回错误或连接断开时，会像下面这样收到（2026-09-27 时。修复预定：[ ]）。

没有完整收到时，请把同样的请求再发一次。连接断开时，也会收取断开前已生成部分的费用（价格与充值）。

联系我们时

Echo 的 API 处理过的响应，不论成功还是失败，都带有请求 ID（区分每一次调用的编号）。响应头的 X-Request-Id 和 request-id 里是同一个值。

请附上下面的信息，通过 https://echohub.io/contact 联系我们。联系表单在 Echo AI Hub 的页面上，会员网站公开后才能使用。

• 出错的时间（日本时间）
• 请求 ID
• 使用的模型 ID 和端点的路径
• 密钥的名称（请不要发送密钥本身）
• HTTP 状态码和错误正文

信息来源