开放 API v1

开发者

用与站内相同的执行器自动化字幕、转录、翻译与配音。Bearer 密钥鉴权、按日配额、用量透明。

快速开始

登录后在此创建密钥。明文密钥只显示一次。
上传文件（POST /api/v1/uploads），保存返回的 objectKey。
创建任务（POST /api/v1/jobs），轮询 GET /api/v1/jobs/{id} 直到产物就绪。
随时通过 GET /api/v1/usage 查询配额。

curl -s https://www.aimp6.com/openapi.json | head -40

# 1. proxy upload
curl -s -X POST https://www.aimp6.com/api/v1/uploads \
  -H "Authorization: Bearer aimp6_live_XXXX" \
  -F "[email protected]"
# -> { "mode":"direct", "objectKey":"inputs/.../interview.mp3" }

# 2. create job
curl -s -X POST https://www.aimp6.com/api/v1/jobs \
  -H "Authorization: Bearer aimp6_live_XXXX" \
  -H "content-type: application/json" \
  -d '{"tool":"ai-subtitles","objectKey":"inputs/.../interview.mp3"}'
# -> 202 { "jobId":"job_...", "poll":"/api/v1/jobs/job_..." }

# 3. poll
curl -s https://www.aimp6.com/api/v1/jobs/job_... \
  -H "Authorization: Bearer aimp6_live_XXXX"

鉴权与限制

每次请求都带上 Authorization: Bearer aimp6_live_...。密钥以 HMAC-SHA256 哈希存储，吊销立即生效。

默认配额：每个密钥每天 200 次请求（按 UTC 重置）。超限返回 429，并带 Retry-After 响应头。
每个响应都包含 x-request-id、x-ratelimit-limit 与 x-ratelimit-remaining。
点数与站内账户余额共用；失败任务会自动退款。

错误码

HTTP	code	含义
400	unsupported_tool	工具未知、缺少 objectKey，或 TTS 未提供文案/授权。
401	unauthorized	密钥缺失、无效或已吊销；任务不属于该密钥。
402	insufficient_credits	余额不足以支付该任务所需点数。
413	unsupported_tool	上传文件超过 200 MB。
429	rate_limited	已达当日配额；请等待 `Retry-After` 秒后重试。
5xx	provider_unavailable	内部或上游故障。已受理的任务失败仍会退款。

合规

你提交的媒体必须拥有合法权利。上传的输入保留 24 小时，产物保留 7 天，到期永久删除。密钥不会出现在日志中；请求日志只记录方法、路径与状态码。

你的 API 密钥

登录后可创建或吊销密钥。

名称	前缀	状态	配额	最近使用
登录后显示密钥列表。