接入排障

接入排障用于快速定位鉴权、模型、参数、额度、任务和回调问题。建议在业务日志中保存 task_id、trace_id、模型名和原始错误对象。

常见错误

HTTP 状态码	`type`	`code`	说明
`400`	`invalid_request_error`	`invalid_request`	请求体格式错误、缺少必填字段或字段类型不正确。
`400`	`invalid_request_error`	`invalid_parameter`	参数值不在模型支持范围内。
`401`	`authentication_error`	`missing_api_key`	请求缺少 `Authorization` header。
`401`	`authentication_error`	`invalid_api_key`	API Key 不存在、已失效或格式错误。
`403`	`permission_error`	`model_not_enabled`	当前账号未开通所请求的模型或能力。
`404`	`not_found_error`	`task_not_found`	任务不存在，或不属于当前账号。
`429`	`rate_limit_error`	`rate_limit_exceeded`	请求频率超过账号或模型限制。
`402`	`billing_error`	`insufficient_balance`	账号余额或额度不足。
`500`	`server_error`	`service_error`	MoonApiX 服务异常，请稍后重试。
`504`	`timeout_error`	`request_timeout`	请求或任务等待超时。

问题	建议
`400`、`422`	检查请求参数和素材，再重新提交。
`401`	检查 API Key 是否正确，并确认没有把占位符当作真实密钥。
`402`、`403`	在 MoonApiX 后台检查余额、额度和模型权限。
`429`	降低并发或拉大重试间隔。
`5xx`	使用指数退避重试，并记录 `task_id` 和 `trace_id`。