Seedance 2.0 API 文档

快速开始

1. 注册账户并完成邮箱验证。
2. 前往钱包充值美元预付余额。
3. 在 API Key 页面创建 Key，并立即安全保存。
4. 提交视频任务，保存响应中的 id，轮询到 completed 后下载。

鉴权

每次请求都在 HTTP Header 中发送 API Key：

Authorization: Bearer YOUR_CHEAPMODEL_API_KEY

缺失、无效或余额不足时，请求会返回对应的 4xx 错误。可以在调用日志和任务日志查看使用记录。

模型

返回当前账户可用模型。MVP 公开以下 8 个固定别名：

curl https://api.cheapmodel.org/v1/models \
  -H "Authorization: Bearer $CHEAPMODEL_API_KEY"

创建视频

以 JSON 创建异步任务。成功响应中的 id 是后续查询和下载使用的任务 ID。

curl https://api.cheapmodel.org/v1/videos \
  -H "Authorization: Bearer $CHEAPMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-fast-720p",
    "prompt": "A glass hummingbird flying through morning fog",
    "seconds": 4,
    "size": "1280x720",
    "generate_audio": false,
    "watermark": false
  }'

请求字段

首版不支持 remix、用户 webhook 或在 POST /v1/videos 中直接上传 multipart 文件。

素材输入

本地文件或公网链接需要先经过同域名的素材入口，得到私有存储的限时 HTTPS URL，再把返回字段放入 POST /v1/videos。输入素材默认在 2 天后清理。

上传本地文件

curl 'https://api.cheapmodel.org/uploads/v1/files?model=seedance-2.0-fast-720p' \
  -H "Authorization: Bearer $CHEAPMODEL_API_KEY" \
  -F 'input_reference=@reference.png' \
  -F 'image_files=@second-reference.webp' \
  -F 'video_files=@movement.mp4'

支持 input_reference、可重复的 image_files、video_files、audio_files。限制如下：

导入外部 HTTPS 链接

curl https://api.cheapmodel.org/uploads/v1/import \
  -H "Authorization: Bearer $CHEAPMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_urls":["https://media.example/reference.webp"]}'

只接受 HTTPS。系统会检查解析地址与每一次重定向，拒绝内网、回环地址、云元数据地址、带账号密码的 URL 和危险跳转。请确保远端文件允许服务端读取且响应类型正确。

查询任务

curl https://api.cheapmodel.org/v1/videos/$VIDEO_ID \
  -H "Authorization: Bearer $CHEAPMODEL_API_KEY"

status 可能为 queued、in_progress、completed 或 failed。建议使用逐步延长的轮询间隔，不要高频请求。

{
  "id": "019...",
  "object": "video",
  "model": "seedance-2.0-fast-720p",
  "status": "in_progress",
  "progress": 48,
  "seconds": "4",
  "size": "1280x720"
}

下载视频

curl -L https://api.cheapmodel.org/v1/videos/$VIDEO_ID/content \
  -H "Authorization: Bearer $CHEAPMODEL_API_KEY" \
  --output result.mp4

仅当任务状态为 completed 时可下载。内容接口返回完整的 HTTP 200 视频流，首版不支持 Range 分段下载。

状态与错误