常见 code：

• 40001：参数缺失或格式不对，按返回里的字段说明改请求。
• 40100：API Key 缺失、无效或已吊销。到控制台核对。
• 40200：余额不足，充值后再试。
• 40400：路径不存在，对照接口文档里的路径。
• 42900：超过这把 Key 在该接口上的每分钟上限，稍后再试。
• 50200：平台侧失败或超时，可以重试，不扣费。
• 50300：接口暂不可用，不扣费。

每次响应的 meta 里有 request_id。排查时把这个编号发给顾问。完整列表也写在接口文档的错误码一节。

重试策略

502、503 和超时类可在退避后重试；400、401、402 应先改参数或账户状态，盲目重试无效。成功一次扣一次，不会对同一失败重复扣费。

和控制台账单核对

控制台里的调用记录与扣费对应成功请求。若对单笔有疑问，用 request_id 查询更方便定位。

常见问题

重试失败的请求会重复扣费吗？

失败本身不扣费。只有某一次返回成功，才扣这一次的费用。