试用错误说明
试用错误说明
以下仅说明可在 Toolswitch 试用实现中核对的响应，不是对外转售 API，也不涵盖所有供应商错误。
| HTTP | reasonKey | 含义 |
| --- | --- | --- |
| 401 | unauthenticated | 请重新登录。 |
| 400 | invalid_input | 请检查提交的参数。 |
| 404 | endpoint_not_found | 未找到请求的工具端点。 |
| 403 | path_params_unsupported | 试用区暂不支持该工具的路径参数。 |
| 403 | over_playground_cap | 请求预估费用超过试用区上限。 |
| 403 | batch_disabled | 当前策略未开放该试用批次。 |
| 403 | billing_frozen | 该账号的计费已冻结。 |
| 403 | user_blocked | 该账号已被禁止试用。 |
| 402 | insufficient_balance | 可用余额不足以完成费用预留。 |
| 409 | idempotency_conflict | 请求标识已被占用。 |
| 429 | personal_quota_reached | 上游 treg 的 tag_blocked 或 tag_spend_cap_reached 映射为此 key。 |
| 429 | service_unavailable | 其他非团队级 treg 错误映射为此 key。 |
| 503 | service_unavailable | 服务暂时不可用。 |
上游响应头 x-treg-error: 1 表示 treg 错误。团队级错误（包括 treg 的 insufficient_balance 和 platform_daily_cap_reached）会被收口为 HTTP 503 与 service_unavailable，不会原样透传，也不代表你的 Toolswitch 余额不足。
未知错误请见上游响应或文档，本站不编造定义。供应商错误也可能出现在试用结果内部，而不是顶层 reasonKey 中。