常见错误 - Hostlinku Docs

所有错误都使用相同的封装：{"error": {"code": "...", "message": "..."}}。完整列表请参见错误。

401 访问被拒绝

API密钥不存在、复制错误、已被撤销或已过期。请确保请求头中使用了Authorization: Bearer sk-...或x-api-key，然后在控制台 → API密钥 中检查密钥状态。

原因有两个：

请阅读错误信息以进行区分。在控制台中查看余额和密钥限额。详情请参见：计费与余额。

该模型的slug在目录中不存在。请直接从GET /v1/models或模型页面获取确切的slug。请勿根据显示名称猜测slug。

虽然存在该模型，但不适用于当前使用的 Service Mode API key。例如：key“Low-Cost”调用了仅包含“Performance”路由的模型。请创建具有相应模式的 key，或选择其他模型。

请求正文未通过验证：messages 为空、字段类型错误或缺少必填字段。响应中包含各字段的详细信息。请参阅 Chat Completions 中的请求正文示例。

请求超限。请查阅 Retry-After 和 RateLimit-* 报头，然后采用指数退避算法重试。被限流器拒绝的请求不会扣除配额。详情：使用情况与限额。

该模型已弃用/不可用，或者上游服务暂时出现故障。对于 UPSTREAM_ERROR，请稍后再试。对于 MODEL_UNAVAILABLE，请检查错误信息中是否包含 replacement_slug。