技术参考
AI API 计费错误
LinkCode AI API 返回的稳定计费错误码，以及充值后的安全重试行为。
位于 https://gateway.linkcode.ai/v1、与 OpenAI 兼容的 AI API 会按以下结构返回错误：
{
"error": {
"code": "insufficient_credits",
"message": "The organization does not have enough credits for this request",
"type": "billing_error"
}
}需要程序分支判断时，请使用 error.code。message 用于展示，不是稳定标识符。
稳定计费错误码
| HTTP 状态码 | error.code | 含义与重试行为 |
|---|---|---|
402 | insufficient_credits | 组织无法预留足够的 credits。该响应在任何上游 AI provider 调用之前生成，因此尚未开始生成结果。充值后可以安全地重试同一个请求。 |
503 | billing_unavailable | LinkCode Cloud 无法建立或持久化用量计费。请退避后重试。该错误既可能在上游调用前出现，也可能在 provider 已返回结果、费用仍在持久化时出现，因此不能据此断定没有生成结果。 |
以上两个错误码都是稳定的客户端契约。其他 HTTP 状态码与未知错误码仍应按一般 API 失败处理。