Seedance 创建任务#

创建异步 Seedance 视频生成任务。

接口#

请求#

import requests

api_key = "<YOUR_UNIGATEWAY_API_KEY>"
base_url = "https://api.unigateway.ai"
headers = {
    "Authorization": "Bearer " + api_key,
    "Content-Type": "application/json",
}

resp = requests.post(
    base_url + "/api/v3/contents/generations/tasks",
    headers=headers,
    json={
        "model": "doubao-seedance-2-0-fast-260128",
        "content": [
            {
                "type": "text",
                "text": "A cinematic tracking shot of a sports car driving through neon streets at night.",
            }
        ],
        "ratio": "16:9",
        "duration": 5,
        "resolution": "720p",
        "generate_audio": False,
        "seed": -1,
    },
)
resp.raise_for_status()
print(resp.json())

curl -sS -X POST "https://api.unigateway.ai/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
      {
        "type": "text",
        "text": "一辆跑车在夜晚的霓虹街道上行驶，电影跟踪镜头。"
      }
    ],
    "ratio": "16:9",
    "duration": 5,
    "resolution": "720p",
    "generate_audio": false,
    "seed": -1
  }'

响应：

{
  "id": "task_123456"
}

创建接口只返回任务 ID。最终视频地址和用量数据需要通过查询任务接口获取。

请求体#

Content URL 来源#

图片、视频、音频输入里的 url 支持：

• 公网可访问 URL
• Data URI，例如 data:image/png;base64,{base64_image}
• 素材库引用，例如 asset://<ASSET_ID>

请求体不能超过 64 MB。大文件不要使用 base64 编码。

文本输入#

{
  "type": "text",
  "text": "天空飘着一朵白云。"
}

图片输入#

image_url 可用于首帧、尾帧和参考图。

只有一张首帧图片时，role 可以省略，也可以设置为 first_frame。

{
  "type": "image_url",
  "image_url": {
    "url": "https://example.com/first-frame.png"
  },
  "role": "first_frame"
}

首尾帧生成需要分别设置 first_frame 和 last_frame。

[
  {
    "type": "image_url",
    "image_url": {
      "url": "https://example.com/first-frame.png"
    },
    "role": "first_frame"
  },
  {
    "type": "image_url",
    "image_url": {
      "url": "https://example.com/last-frame.png"
    },
    "role": "last_frame"
  }
]

参考图需要设置 role 为 reference_image。Seedance 最多支持 9 张参考图。

{
  "type": "image_url",
  "image_url": {
    "url": "asset://ua_123"
  },
  "role": "reference_image"
}

视频输入#

参考视频使用 video_url，并将 role 设置为 reference_video。

{
  "type": "video_url",
  "video_url": {
    "url": "https://example.com/reference-video.mp4"
  },
  "role": "reference_video"
}

音频输入#

参考音频使用 audio_url，并将 role 设置为 reference_audio。

{
  "type": "audio_url",
  "audio_url": {
    "url": "https://example.com/reference-audio.mp3"
  },
  "role": "reference_audio"
}

多模态示例#

{
  "model": "doubao-seedance-2-0-fast-260128",
  "content": [
    {
      "type": "text",
      "text": "生成一段产品主视觉视频，保持角色外观一致，镜头运动平滑。"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "asset://ua_character_reference"
      },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/motion-reference.mp4"
      },
      "role": "reference_video"
    }
  ],
  "ratio": "16:9",
  "duration": 5,
  "resolution": "720p",
  "generate_audio": false,
  "seed": -1
}

常见失败#