API 接入文档

认证

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

通过 MCP 连接 AI 助手

使用支持 Streamable HTTP 和自定义 Authorization 请求头的客户端，将以下地址与账户 API 密钥填入连接设置。目前不支持 OAuth 登录。

URL: https://paddle-sandbox.superseedance.si/api/mcp
Transport: Streamable HTTP
Authorization: Bearer YOUR_STUDIO_API_KEY

list_models · quote_video · get_credit_balance · list_videos · get_video · create_video

查询模型、报价、余额与任务不消耗积分。生成前，让助手展示提示词、参数和积分报价，确认后再提交。创建任务必须提供 confirmCharge: true、与报价一致的 confirmedCredits 和 idempotencyKey；恢复中断的请求时，保持同一个键和相同参数。

MCP 接入与协议说明 →

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://paddle-sandbox.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。

机器可读 API 文档 →

积分购买状态

账户与作品库

视频生成

视频分析

支付

邮件