跳转到主要内容
发生错误时,Venice API 会返回 HTTP 状态码和描述性消息。某些错误还包含额外字段,例如退款状态、建议重试模型、验证细节或请求 ID。

错误响应格式

大多数错误返回一个带有人类可读消息的 error 字段:
某些端点会包含端点特有的额外字段。例如,视频审核错误可能包含是否退还了额度的信息:
验证错误可能包含带有字段级验证信息的 details 和 issues 字段:
某些 OpenAI 兼容端点可能针对特定情况(如上下文长度错误)返回 OpenAI 风格的错误对象:

缺少凭据

不带任何凭据的请求会返回 402 Payment Required,而不是 401。每个付费路由也都接受 x402 钱包认证,因此响应是一个支付质询:它包含 PAYMENT-REQUIRED 响应头,以及描述两种认证方式的响应体。
如果你打算使用 API 密钥,请检查是否设置了 Authorization: Bearer 请求头。存在但无效的密钥会返回 401。

请求格式错误

这些错误产生于读取请求体阶段,早于任何端点专属的校验。 错误的 Content-Type 返回 400,而不是 415。因大小限制返回的 413 响应还包含一个 code 字段:

错误码

其他错误

上表并不详尽。部分错误返回时不带已列出的错误码,且消息内容可能因模型和端点而异,因此请根据 HTTP 状态而非消息文本进行分支处理。可能遇到但未列入上表的错误: