Seedance 2.0 文生视频接入

本教程说明如何使用 cURL 命令行调用 TArk 元舟平台的 Seedance 2.0（Tark1/doubao-seedance-2.0）模型进行文生视频，并查询生成进度及下载视频。

开始前，请先按照快速开始创建 API Key。

请避免在不受信任的共享设备或公开代码中直接暴露 API Key。密钥泄露后应立即在 TArk 控制台停用并重新创建。

请求参数说明

视频生成接口为异步任务模式，向 https://www.tarkcloud.com/v1/videos 提交生成任务后会返回唯一的任务 ID (task_id)，后续通过任务 ID 查询生成结果。

接口地址

POST https://www.tarkcloud.com/v1/videos

请求体参数

字段	类型	必填	默认/示例值	含义说明
`model`	string	是	`Tark1/doubao-seedance-2.0`	调用的视频生成模型标识
`prompt`	string	是	`一群猫在主人的床上唱歌`	视频生成提示词
`seconds`	string / number	否	`"15"`	生成视频时长（秒）
`moderator`	boolean	否	`false`	内容审核开关，`false` 表示关闭审核
`metadata.resolution`	string	否	`"720p"`	视频分辨率，如 `"720p"`
`metadata.ratio`	string	否	`"adaptive"`	画面比例，如 `"adaptive"`（自适应）
`metadata.generate_audio`	boolean	否	`true`	是否生成配套音频
`metadata.watermark`	boolean	否	`true`	是否开启水印
`metadata.seed`	integer	否	`487037789`	随机种子，固定种子可复现生成效果

步骤一：发起视频生成任务

根据您的操作系统与终端环境选择对应的 cURL 命令格式提交生成请求：

Linux / macOS (Bash)

cURL (Linux / macOS)

curl -X POST "https://www.tarkcloud.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "moderator": false,
    "model": "Tark1/doubao-seedance-2.0",
    "seconds": "15",
    "metadata": {
      "resolution": "720p",
      "ratio": "adaptive",
      "generate_audio": true,
      "watermark": true,
      "seed": 487037789
    },
    "prompt": "一群猫在主人的床上唱歌"
  }'

Windows (CMD)

cURL (Windows CMD)

curl -X POST "https://www.tarkcloud.com/v1/videos" ^
  -H "Authorization: Bearer YOUR_API_KEY" ^
  -H "Content-Type: application/json" ^
  -d "{\"moderator\": false,\"model\": \"Tark1/doubao-seedance-2.0\",\"seconds\": \"15\",\"metadata\": {\"resolution\": \"720p\",\"ratio\": \"adaptive\",\"generate_audio\": true,\"watermark\": true,\"seed\": 487037789},\"prompt\": \"一群猫在主人的床上唱歌\"}"

Windows (PowerShell)

cURL (PowerShell)

curl.exe -X POST "https://www.tarkcloud.com/v1/videos" `
  -H "Authorization: Bearer YOUR_API_KEY" `
  -H "Content-Type: application/json" `
  -d '{
    \"moderator\": false,
    \"model\": \"Tark1/doubao-seedance-2.0\",
    \"seconds\": \"15\",
    \"metadata\": {
      \"resolution\": \"720p\",
      \"ratio\": \"adaptive\",
      \"generate_audio\": true,
      \"watermark\": true,
      \"seed\": 487037789
    },
    \"prompt\": \"一群猫在主人的床上唱歌\"
  }'

提交请求后，服务端会返回一段包含 task ID（如 task_yj2YTtd3UKQuntP2NWW1D7n2sjeecS60）的 JSON 响应，请妥善保存该 ID 以便后续查询。

返回 Task ID

步骤二：查询视频生成进度

使用获取到的 task_id 调用查询接口：

Linux / macOS

cURL

curl -X GET "https://www.tarkcloud.com/v1/videos/task_yj2YTtd3UKQuntP2NWW1D7n2sjeecS60" \
  -H "Authorization: Bearer YOUR_API_KEY"

Windows (CMD)

CMD

curl -X GET "https://www.tarkcloud.com/v1/videos/task_yj2YTtd3UKQuntP2NWW1D7n2sjeecS60" ^
  -H "Authorization: Bearer YOUR_API_KEY"

查询结果通常有以下两种状态：

生成中：视频仍在排队或渲染生成阶段。
生成完成：返回状态为完成，并在响应体中附带视频文件的下载 URL。

步骤三：下载生成的视频

获取到视频 URL 后，可以通过命令行工具将视频下载到本地：

使用 wget

wget

wget "https://your-video-url.mp4" -O output.mp4

使用 wget 下载视频

使用 cURL

cURL

curl -L -o output.mp4 "https://your-video-url.mp4"

Windows 用户如果未安装 wget，可直接使用系统内置的 curl.exe -L -o output.mp4 "URL" 或 PowerShell 的 Invoke-WebRequest -Uri "URL" -OutFile output.mp4 进行下载。

Seedance 2.0 文生视频接入

On this page