错误处理

FUNCD 返回 JSON 错误对象。建议客户端同时记录 HTTP 状态、code 和请求 ID。

{
  "error": {
    "message": "可用积分不足，请先充值",
    "type": "insufficient_quota",
    "code": "INSUFFICIENT_CREDITS",
    "param": null
  }
}

常见状态

HTTP	Code	含义	处理方式
400	invalid_request_error	参数或请求格式错误	检查模型标识、消息和 JSON
401	invalid_api_key	密钥无效、被撤销或已过期	更换有效密钥
402	INSUFFICIENT_CREDITS	账户余额或密钥费用限额不足	充值或调整密钥限额
403	model_not_allowed	当前密钥没有模型权限	修改密钥的模型范围
404	not_found	模型或端点不存在	查询 /v1/models
429	rate_limit_error	请求或 Token 速率过高	指数退避后重试
5xx	server_error	平台或上游暂时不可用	保留请求 ID 后重试

重试建议

• 仅对 429、连接超时和部分 5xx 自动重试。
• 使用指数退避并加入随机抖动。
• 为业务请求设置自己的幂等标识，避免重复业务副作用。
• 不要对 400、401、402 或 403 无限重试。