API 接入文档

认证

注册并验证邮箱后，在账户页创建 API 密钥。浏览器使用 HttpOnly 会话 Cookie；服务端使用 Bearer 鉴权。不要把 API 密钥放到前端代码中。

POST /api/quote

发送 model、duration、resolution、aspectRatio、mode、nativeAudio 和 draft。响应包含积分、confirmed（本站价格已确认）和 generationAvailable（当前可生成）。它是本站积分价格，并非供应商账单。

Seedance 2.5 支持 4–30 秒、480p/720p/1080p 与音频开关；草稿限 480p。首帧图生跟随原图比例，文生和单图参考另支持 21:9 与自动画幅。5 秒、16:9 的 480p / 720p / 1080p 分别为 83 / 187 / 462 积分。自动画幅按该分辨率已列出的最大画布计算固定报价。

{
  "model": "seedance-2.5",
  "duration": 4,
  "resolution": "480p",
  "aspectRatio": "16:9",
  "nativeAudio": false,
  "draft": false,
  "mode": "text"
}

POST /api/generate

需要已验证账户、已配置的供应商及足够积分。同一请求的网络重试须复用同一个 idempotencyKey。接口返回 HTTP 202 与 {job}，不会返回内置样片。图片与参考模式先向 POST /api/assets 上传 file，再携带 assetId。

curl https://superseedance.si/api/generate \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $STUDIO_API_KEY" \
  -d '{"model":"seedance-2.5","duration":4,"resolution":"480p","aspectRatio":"16:9","nativeAudio":false,"draft":false,"mode":"text","locale":"zh","prompt":"A cup on a stone table, slow camera push-in, soft morning light.","idempotencyKey":"replace-with-a-new-uuid"}'

POST /api/analyze

发送六张 JPEG 帧的 data URL、locale 和唯一 idempotencyKey。每帧不超过 1 MB、1280 × 720 像素。已验证账户按配置支付分析积分，明确失败会退款。仅分析采样帧，不包含音频或完整视频。

连接中断后，用 GET /api/analyze?id=ID 或 ?idempotencyKey=KEY 恢复查询。不要自动重发结果不明的请求。

查询、取消与下载

每 5–10 秒查询 GET /api/jobs/{id}。状态依次为 queued → submitting → running → saving → succeeded。失败或取消任务会且仅会退回一次预扣积分。只有 queued 任务可通过 POST /api/jobs/{id}/cancel 取消。

从 GET /api/jobs/{id}/video?download=1 下载保存的结果。文件需要所有者鉴权并支持 Range 请求。attention 表示供应商状态需核对，在处理完之前不要重复提交同一任务。

错误与限制

400 · 参数无效　401 · 需要登录　402 · 积分不足　403 · 验证或来源检查未通过　409 · 状态或幂等冲突　429 · 频率受限　503 · 服务尚未配置

每账户最多三个进行中任务。图片：JPG/PNG/WebP，不超过 10 MB，宽高均为 300–6000 像素，宽高比 0.4–2.5。每账户素材上限 100 张 / 100 MB。