快速开始

1. 设置认证

在账户设置中创建新密钥，保存在服务端密钥管理工具中。密钥只展示一次。

export SEEDANCE_BASE_URL="https://seedance2-5.com/api/v1"
export SEEDANCE_API_KEY="YOUR_API_KEY"

2. 准备请求并报价

cat > video.json <<'JSON'
{
  "model": "seedance-2.5-lite",
  "mode": "text-to-video",
  "prompt": "A cat walking through a sunny garden, cinematic camera movement",
  "parameters": {
    "duration_seconds": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  },
  "max_cost_credits": 80
}
JSON

curl --fail-with-body "$SEEDANCE_BASE_URL/quotes" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @video.json

报价返回 cost_credits，不会生成或扣积分。本例 Seedance 2.5 Lite 的 8 秒视频当前为 80 积分；超过 max_cost_credits 的价格会在生成前被拒绝。

3. 提交生成

curl --fail-with-body "$SEEDANCE_BASE_URL/videos" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: video-order-0001" \
  --data-binary @video.json

每个新的生成意图使用不同幂等标识；超时重试必须保留同一 API 密钥、幂等标识和请求体。保存 202 返回的 id。

{
  "id": "api_0000000000000000000000000000000000000000000000000000000000000000",
  "model": "seedance-2.5-lite",
  "status": "processing",
  "created_at": "2026-10-03T12:00:00.000Z",
  "credits": {
    "cost": 80
  },
  "outputs": [],
  "error": null
}

4. 查询并下载

curl --fail-with-body "$SEEDANCE_BASE_URL/generations/GENERATION_ID" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

将 GENERATION_ID 替换为返回的 id。同一个处理中任务至少间隔 10 秒查询。status 为 success 后，在 expires_at 之前下载 outputs[].url。链接最多有效 15 分钟，生成文件保留 14 天。

图片生成使用图片模型、text-to-image 和 POST /images。参考图片请查看图片输入.

快速开始

1. 设置认证

2. 准备请求并报价

3. 提交生成

4. 查询并下载

On this page