调用 API 前必须先获取 API Key

所有 API 请求均需通过 X-API-Key 请求头进行身份认证。没有有效的 API Key，任何端点都无法调用。

API 调用限制

速率限制

为保证服务质量，API 接口设有调用频率限制：

套餐 每日上传次数 每月请求次数
免费版 20 无限
高级版 500 无限
专业版 1,000 无限
旗舰版 5,000 无限

单文件大小限制

套餐 最大文件大小
免费版 2 MB
高级版 10 MB
专业版 20 MB
旗舰版 50 MB

常见错误码

状态码 说明 解决方案
401 API Key 无效或已过期 检查 API Key 是否正确，必要时重新生成
403 权限不足 确认套餐是否支持该 API 功能
413 文件过大 检查文件大小是否超过套餐限制
429 请求过于频繁 降低请求频率，稍后重试
400 请求参数错误 检查请求参数是否符合 API 文档要求

超限后

  • 达到每日上传上限后，当日无法继续上传，次日 00:00 (UTC+8) 重置
  • 建议升级套餐以获得更高限制