错误处理

所有错误返回统一结构,HTTP 状态码 + JSON:

{ "error": { "code": "quota_exceeded", "message": "本月配额已用尽,请升级或下月再试" } }

状态码	code	含义
400	bad_request	参数或请求体不合法(如畸形 JSON、缺必填项)
400	country_not_supported	/v1/image-search 的 country 仅支持 US、CN
401	invalid_key	缺少或无效的 API Key
402	—	积分 / API 配额不足,需充值或升级
403	forbidden_entitlement	当前档位无权使用该能力
405	method_not_allowed	HTTP 方法错误(如对 POST 端点用了 GET)
429	quota_exceeded	月配额用尽 或 触发限流

计费保护

参数校验(含坏图、country 校验)在扣费之前完成 —— 400 类错误不消耗配额。调用彻底失败时已扣的点会退回。