Seedance-2 创建

Seedance-2 使用原生任务接口创建视频生成任务。该接口为异步接口,创建成功后返回任务 ID,可通过回调或查询接口获取结果。

Base URL

https://vip.xmsmartlink.com/

Endpoint

POST /v1/task/create

请求头

Header必填说明
AuthorizationBearer <API_KEY>
Content-Typeapplication/json
X-Trace-ID请求跟踪 ID,建议每次请求唯一,便于排查问题。

参数说明

参数类型必填说明
modelstring模型名称,例如 doubao-seedance-2.0
contentarray多模态内容数组,至少包含一条 type=text 的提示词内容。
generate_audioboolean是否生成音频。
ratiostring视频画幅比例,例如 16:99:16
durationnumber视频时长,单位秒。
watermarkboolean是否添加水印。
callback_urlstring任务状态变化回调地址。
resolutionstring输出分辨率,例如 720p
seedinteger随机种子。

content 字段

参数类型必填说明
typestring内容类型,可传 textimage_urlvideo_urlaudio_url
textstring条件必填type=text 时传入提示词。
image_url.urlstring条件必填type=image_url 时传入公网图片 URL 或 Asset:// 地址。
video_url.urlstring条件必填type=video_url 时传入公网视频 URL 或 Asset:// 地址。
audio_url.urlstring条件必填type=audio_url 时传入公网音频 URL 或 Asset:// 地址。
rolestring素材角色,例如 reference_imagefirst_framelast_framereference_videoreference_audio

素材要求

Seedance-2 接口不支持 base64 图片。图片、视频和音频素材需要先上传到云存储,使用公网 URL 调用;真人授权素材可以先通过审核系列入库,再在对应的 url 字段传入素材审核返回的 Asset:// 地址。

请求示例

curl -X POST https://vip.xmsmartlink.com//v1/task/create \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Trace-ID: $TRACE_ID" \
  -d '{
    "model": "doubao-seedance-2.0",
    "content": [
      {
        "type": "text",
        "text": "全程使用视频1的第一视角构图,全程使用音频1作为背景音乐,生成一段果茶宣传视频。"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/image1.jpg"
        },
        "role": "reference_image"
      },
      {
        "type": "video_url",
        "video_url": {
          "url": "https://example.com/video1.mp4"
        },
        "role": "reference_video"
      },
      {
        "type": "audio_url",
        "audio_url": {
          "url": "https://example.com/audio1.mp3"
        },
        "role": "reference_audio"
      }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 11,
    "watermark": false
  }'

首尾帧示例

{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "根据首帧和尾帧图片,生成流畅过渡的高清视频"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first.jpg"
      },
      "role": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/last.jpg"
      },
      "role": "last_frame"
    }
  ],
  "generate_audio": true,
  "ratio": "16:9",
  "duration": 8,
  "watermark": false
}

已授权真人素材示例

{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "<your prompt>"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "Asset://asset-20260421174640-kqkcc"
      },
      "role": "reference_image"
    }
  ]
}

响应示例

{
  "id": "cgt-20260416141540-t7n9r"
}

API Reference

底层接口定义已收录在左侧“底层 API Reference / Seedance-2 视频”分组中。