文件限制与常见错误

文件类型和大小

图床 Key 由管理员单独配置允许的类型和大小。常见默认值如下，实际以客服开通和后台配置为准：

如果该图床 Key 没有开放某种类型，上传会被拒绝。

系统会同时检查文件声明的类型和文件实际内容，不能只修改文件后缀绕过限制。

保存周期和访问额度也由图床 Key 单独配置。

expires_in 不能超过管理员设置的最长保存时间。

错误响应格式

{
  "error": {
    "code": "MEDIA_UPLOAD_KEY_INVALID",
    "message": "上传凭证无效",
    "type": "media_upload_error"
  }
}

常见错误

处理建议

• 遇到 429 时，建议等待几秒后重试，并在程序中使用逐步延迟重试；
• 遇到 Key、权限或配额问题，请联系 MaomaoToken 客服处理；
• 收到上传失败响应时，不要直接假定素材不存在，可以先使用列表接口确认状态；
• 收到 410 时，素材已过期，需要重新上传并保存新的 public_url。