Operational behavior
常见回应
所有错误回应都含一个 request_id — 联络支援时请附上。错误外层格式会跟随你呼叫的 SDK 格式（OpenAI / Anthropic / Gemini）。
400
Bad request — 缺栏位、body 格式错误，或不支援的功能（例如 Anthropic system 用阵列）。
401
API key 缺失、被停用、过期或无法辨识。
402
钱包或 credit 池已耗尽。储值后即可恢复。
403
该模型未在此 project 启用。
429
速率限制、配额，或 provider 冷却中。若有 Retry-After 请遵守。
502
Provider 连线失败或逾时。可安全重试。
503
该模型的所有 provider 皆 circuit-open。Retry-After: 60。
5xx
Provider 或 Gateway 错误。请查 Console 的 request logs。
200 但内容为空
请求可能回传 200 OK 却是空讯息 — 不是错误，只是没有文字。这几乎都是由 request 参数造成，而非失败。最常见的原因是 reasoning(extended thinking)模型的 max_tokens 设太低:整个额度在产生任何可见输出前就被内部推理吃完，于是内容回空。
在本平台上，这种请求通常会显示零 token 用量、也不会扣 credits——空的 200 加上空的 usage,就是这个情况的特征,不是计费 bug。解法:把 max_tokens 调高到「思考预算 + 预期输出」都够用,或关闭 extended thinking。在假设有文字前,一律先检查 finish_reason / stop_reason 与 usage。