错误说明
先区分认证、参数、资源和服务故障，再决定处理方式。
初始内容依据参考站公开技术信息整理，非黔惠科技接口上线承诺。实际 API 地址、模型、费用与权限请在接入前确认。
错误对象
常见错误包含 error.message、error.type、error.param 与 error.code。业务侧同时检查 HTTP 状态和任务状态；HTTP 200 不代表异步任务已成功。
json
{
"error": {
"type": "invalid_request_error",
"code": "invalid_prompt",
"param": "prompt",
"message": "请提供有效提示词。"
}
}常见 HTTP 状态
400 / 422：格式、字段类型或范围不正确。 401：密钥缺失、失效或不匹配。 403：权限或访问策略限制。 404：模型、资源或任务不存在。 429：频率或配额限制。 500 / 502 / 503 / 504：服务故障或超时，结合错误码处理。
媒体与模型错误
model_not_found、unsupported_model_endpoint 需要检查模型与端点。invalid_image_input、invalid_video_image 需要检查素材。video_not_completed 表示暂不能下载成片。content_policy_violation 应修改不符合规范的输入，而不是绕过限制。
重试与排障
认证和参数错误先修正请求，不自动重复提交。暂时性故障使用带抖动的有限退避；异步任务创建后保存 ID，优先查询原任务，避免重复收费。日志应隐藏密钥与敏感素材链接。
内容整理：2026-10-20参考来源 ↗