errorcode

错误码

本文档面向平台使用者，汇总了调用 AI 模型接口时可能遇到的内部错误码及其解决方案。 响应格式：错误响应遵循 OpenAI 格式：{"error": {"message": "...", "type": "neolink_error", "code": "..."}}。 如何定位：可通过 HTTP 状态码快速定位错误分类，再结合响应体中的 code 或 message 字段匹配具体错误。

通用 HTTP 状态码

Status	含义	常见原因
400	请求参数有误	缺少/非法参数、消息体格式错误、内容安全拦截
401	鉴权失败	API Key 缺失、错误或已失效
403	无权限 / 账户受限	套餐未订阅或过期、余额不足、无资源访问权限
404	资源不存在	模型不存在或无权访问、指定资源未找到
429	触发限流 / 额度用尽	超出 RPM/TPM 限制、套餐用量达上限
500	服务内部异常	网关内部错误，请稍后重试

常见错误码

HTTP	Type	Code	含义与处理建议
400	BadRequest	MissingParameter	请求缺少必要参数，请查阅 API 文档补全。
400	BadRequest	InvalidParameter	请求包含非法参数，请查阅 API 文档检查参数值。
400	BadRequest	InvalidArgumentError（MissingRole）	messages 列表中存在缺少 role 字段的消息体。
400	BadRequest	InvalidArgumentError.UnknownRole	消息体中的 role 值不被支持（仅支持 system / user / assistant 等）。
400	BadRequest	InvalidArgumentError.InvalidImageDetail	image_url 的 detail 仅接受 auto / high / low。
400	BadRequest	InvalidImageURL.EmptyURL	传入的图片 URL 为空。
400	BadRequest	InvalidImageURL.InvalidFormat	图片无法解析，可能是 Base64 格式不正确、数据损坏或格式不支持。
400	BadRequest	OutofContextError	文本与图片编码后的总 token 数超过了模型上下文长度限制。
400	BadRequest	SensitiveContentDetected	输入内容可能包含敏感信息，请更换后重试。
400	BadRequest	InputSensitiveContentDetected	输入的文本 / 图片 / 视频 / 音频可能包含敏感信息，请更换后重试。
400	BadRequest	OutputSensitiveContentDetected	生成的内容可能包含敏感信息，请更换输入内容后重试。
400	BadRequest	SensitiveContentDetected.PolicyViolation	输入或输出内容可能违反平台规定，请更换后重试。
401	Unauthorized	AuthenticationError	请求携带的 API Key 缺失或无效，请检查鉴权凭证（Authorization: Bearer ）。
403	Forbidden	InvalidSubscription	Coding Plan 套餐未订阅或已过期，请在控制台查看订阅状态或完成开通 / 续订。
403	Forbidden	InvalidAccountStatus	当前账号状态异常，如需协助请联系平台客服。
403	Forbidden	AccountOverdueError	账户余额 / Credits 不足，请充值后继续使用。
403	Forbidden	AccessDenied	没有访问该资源的权限，请检查权限设置或联系管理员。
404	NotFound	ModelNotFound	指定的模型不存在或您无权访问，请检查 model 取值。
404	NotFound	UnsupportedModel	当前模型不支持 Coding Plan，请参考文档选择受支持的模型。
404	NotFound	ResourceNotFound	指定资源未找到，请确认请求参数后重试。
429	TooManyRequests	RateLimitExceeded.RPM	已超过每分钟请求数（RPM）限制，请稍后重试。
429	TooManyRequests	RateLimitExceeded.TPM	已超过每分钟 Token 数（TPM）限制，请稍后重试。
429	TooManyRequests	AccountRateLimitExceeded	请求过于频繁，已超出 RPM / TPM 限制，请降低请求频率后重试。
429	TooManyRequests	QuotaExceeded	已超出 Coding Plan 的 5 小时 / 周 / 月用量额度，将于额度刷新时间（reset_time）后恢复。
500	InternalServerError	InternalServiceError	网关内部异常，请稍后重试；若持续出现请联系平台客服。