错误契约#
错误使用 { error: { message, type, code } }。切勿无限重试。
| HTTP | 代码 | 该怎么做 |
|---|---|---|
| 400 | invalid_request | 修复 JSON、必填字段或令牌限制。 |
| 401 | invalid_api_key | 检查密钥和 Bearer 标头；如果已撤销，请轮换。 |
| 402 | insufficient_balance | 检查合格的确认充值、可用余额和密钥预算；每次新充值必须至少为 100 美元。 |
| 403 | model_not_allowed | 更新密钥允许列表或选择允许的模型。 |
| 404 | model_not_found | 获取 /v1/models 并使用确切的 ID。 |
| 409 | pending_reconciliation | 等待使用对账后再重试操作。 |
| 413 | request_too_large | 拆分输入或使用更大的上下文。 |
| 422 | unsupported_feature | 选择支持该功能的部署。 |
| 429 | quota_exceeded | 如果提供了 Retry-After，请遵守并使用有界重试；不提供公共免费试用配额。 |
| 502 | upstream_error | 使用有界退避重试；检查状态。 |
| 503 | service_unavailable | 重试前检查服务状态和模型可用性。 |
避免重复工作#
不要因为连接断开就认为推理请求是免费的。检查您的使用记录。存款根据提供方交易身份独立幂等。
获取帮助#
使用支持指南诊断失败的步骤，并准备一份包含错误代码、UTC 时间、模型和人工复现的报告。本地报告工具不会发送工单。请勿在报告中包含凭据和客户内容。
请求示例
curl https://weightsapi.com/v1/chat/completions \
-H "Authorization: Bearer $WEIGHTSAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Qwen/Qwen3-32B",
"messages": [
{
"role": "user",
"content": "Hello!"
}
],
"stream": true
}'