快速开始

Seeddance API 是异步 JSON API，支持文生视频、图生视频和参考素材生成视频。所有请求都使用 https://www.seeddance.io 作为基础 URL。

01POST
/v1/videos/generations
02读取
task_id
03GET
/v1/tasks/{task_id}
04完成
completed + video_url

1. 创建 API 密钥

前往设置 → API 密钥创建密钥。完整密钥只显示一次，请立即复制并保存到服务端的密钥管理工具中。

2. 创建生成任务

cURL

curl https://www.seeddance.io/v1/videos/generations \
  -H "Authorization: Bearer sk_sd_example" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-fast",
    "prompt": "A paper boat crossing a rain-soaked neon street, cinematic camera movement",
    "duration": 5,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

响应

{
  "task_id": "vid_01JZK7R7KCYQ3T9F33A7K0J6XB",
  "status": "pending",
  "created_at": "2026-07-22T08:30:00.000Z"
}

JavaScript

const response = await fetch('https://www.seeddance.io/v1/videos/generations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer sk_sd_example',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'seedance-2.0-fast',
    prompt: 'A paper boat crossing a rain-soaked neon street',
    duration: 5,
    quality: '720p',
  }),
});

if (!response.ok) throw new Error(await response.text());
const task = await response.json();
console.log(task.task_id);

Python

import requests

response = requests.post(
    "https://www.seeddance.io/v1/videos/generations",
    headers={"Authorization": "Bearer sk_sd_example"},
    json={
        "model": "seedance-2.0-fast",
        "prompt": "A paper boat crossing a rain-soaked neon street",
        "duration": 5,
        "quality": "720p",
    },
    timeout=30,
)
response.raise_for_status()
task_id = response.json()["task_id"]
print(task_id)

3. 轮询任务

任务状态为 pending 或 processing 时，每隔 5–10 秒查询一次，并使用指数退避。

curl https://www.seeddance.io/v1/tasks/vid_01JZK7R7KCYQ3T9F33A7K0J6XB \
  -H "Authorization: Bearer sk_sd_example"

当 status 变为 completed，从 output.video_url 读取可长期访问的视频地址。如果任务变为 failed，请停止轮询。

已完成的任务

{
  "task_id": "vid_01JZK7R7KCYQ3T9F33A7K0J6XB",
  "status": "completed",
  "model": "seedance-2.0-fast",
  "output": {
    "video_url": "https://media.seeddance.io/videos/vid_01JZK7R7KCYQ3T9F33A7K0J6XB.mp4",
    "duration": 5,
    "quality": "720p"
  },
  "credits_used": 25,
  "error": null,
  "created_at": "2026-07-22T08:30:00.000Z",
  "completed_at": "2026-07-22T08:31:12.000Z"
}

4. 查看可用积分

curl https://www.seeddance.io/v1/credits \
  -H "Authorization: Bearer sk_sd_example"

available 是新任务当前可以使用的积分。reserved 是进行中任务预留的积分，只有任务成功完成后才会扣除。