文档中心

AI MediaKit

其他

错误码

错误码

当您调用 AI MediaKit 的 API 接口时，如果请求处理失败，系统将返回一个包含错误信息的 JSON 响应。一个典型的错误响应结构如下：

code: 错误类型代码，供程序识别。

message: 对错误的详细描述，供开发者阅读。

request_id: 本次请求的唯一标识。当您需要技术支持时，请务必提供此 ID。

错误码列表

错误码 (code)	HTTP 状态码	描述	建议解决方案
AuthenticationError	401 Unauthorized	API 密钥或认证信息缺失、无效。	请检查请求头中是否正确设置了有效的 api-key 或 Authentication 信息。
MissingParameter	400 Bad Request	请求中缺少了必要的参数。	请检查 API 文档，确保请求中包含了所有必需的参数（例如 tool_name 或 task_id），并且参数名拼写正确。
InvalidParameter	400 Bad Request	请求中的参数值无效、格式不正确或不符合业务逻辑。	请仔细阅读错误响应中的 message 字段，它会指明具体问题。常见情况包括：请求体格式错误：请求体为空或非法的 JSON 格式。请确保 Content-Type 请求头已设为 application/json。资源不存在：请求的 tool (工具) 或 task (任务) 不存在。请检查名称或 ID 是否拼写正确。参数值无效：为参数提供了不支持的值（如枚举范围之外的值）、格式错误（如非法的 URI）或超出边界（如视频时长超限）。工具特定错误：参数组合不符合工具要求，或输入文件不满足特定工具的处理条件（如分辨率、格式限制）。调用模式错误：对仅支持异步调用的工具发起了同步请求，反之亦然。
AccessDenied	403 Forbidden	禁止访问。通常是由于权限不足或服务状态限制。	请检查：您使用的工具是否已停用。账号是否有访问相关依赖服务（如对象存储）的权限。
TaskCanceled	410 Gone	任务已被取消。	这是一个终态，表示任务已成功取消，无法再获取其状态或结果。
RequestLimitExceeded	429 Too Many Requests	API 调用频率或并发数超出了限制。	请降低您的 API 调用频率。可以考虑使用指数退避策略进行重试。
InternalServiceError	500 Internal Server Error	服务端内部发生未知错误。	建议您稍等片刻后直接重试。
DownloadFileError	500 Internal Server Error	服务端下载用户提供的媒体文件时失败。	请检查您提供的媒体文件 URL 是否可公网访问、是否在有效期内、文件大小是否超出限制。
AbilityProcessingError	500 Internal Server Error	后端原子能力处理失败。	任务执行时，底层的处理服务发生错误。请根据 message 中的具体信息（例如“格式或分辨率超出限制”）调整输入文件或参数。
ServiceInitializingError	503 Service Unavailable	服务正在初始化，临时不可用。	请稍等片刻后重试。
InternalServiceTimeout	504 Gateway Timeout	服务端处理超时。	通常是临时性问题，建议稍后重试。

最近更新时间：2026.07.01 14:41:58

这个页面对您有帮助吗？

有用

有用

无用

无用