创建 Seedance 视频任务

接口说明

提交 Seedance 2.0 视频生成任务。该接口是异步接口，成功提交后返回任务 ID，不会立即返回视频文件。

支持模型

seedance_2.0_fast

seedance_2.0

seedance2.0_fast_vision

Seedance_2.0_mini_lite 当前仍在内部适配中，暂不作为公开 /v1/videos 模型发布。

认证方式

Authorization: Bearer {{YOUR_API_KEY}}

轮询方式

提交成功后，取响应里的 id，调用 GET /v1/videos/{task_id} 查询状态。状态为 completed 后，再调用 GET /v1/videos/{task_id}/content 下载 MP4。

回调通知

当前 Nevo 对外已验证链路是轮询查询，不承诺 callback_url 已作为公开能力可用。即使上游适配器存在 callback_url 字段，接入方也应先按轮询实现。后续如果开放回调，需要由 Nevo 明确发布回调验签、重试、事件格式和安全限制。

cURL 示例

使用案例

适合短视频广告素材、商品动态展示、社媒视频草稿、图生视频动效预览。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

文生视频示例

{
  "model": "seedance2.0_fast_vision",
  "prompt": "一只白色机器人在海边拿着咖啡散步，电影感，平滑运镜",
  "seconds": "5",
  "metadata": {
    "resolution": "720p",
    "ratio": "16:9",
    "watermark": false
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "id": "task_KNg2gz1vWF0jKhPOBbvCdkGEMzMG804I",
  "task_id": "task_KNg2gz1vWF0jKhPOBbvCdkGEMzMG804I",
  "object": "video",
  "model": "seedance2.0_fast_vision",
  "status": "queued",
  "progress": 0,
  "created_at": 1783060800
}

创建 Seedance 视频任务

接口说明#

支持模型#

认证方式#

轮询方式#

回调通知#

cURL 示例#

使用案例#