Seedance 2.0

Seedance 2.0 是字节跳动最新的视频生成模型，通过 Upmore API 提供。支持文生视频、图生视频、多模态参考输入、视频编辑、视频延长及同步音频生成。

核心能力

功能	说明
文生视频	根据文本描述生成视频
图生视频（首帧）	使用一张图片作为首帧
图生视频（首尾帧）	使用两张图片分别作为首帧和尾帧
多模态参考	组合图片、视频、音频作为参考（1–9 张图片，最多 3 个视频，最多 3 段音频）
编辑视频	使用参考图片修改现有视频中的元素
延长视频	延长和拼接参考视频
生成有声视频	自动生成同步的人声、音效和背景音乐
联网搜索增强	结合实时互联网内容增强生成效果（仅文生视频）
返回视频尾帧	获取生成视频的最后一帧

输出规格

属性	值
分辨率	480p、720p、1080p
宽高比	16:9、4:3、1:1、3:4、9:16、21:9、adaptive
时长	4–15 秒
格式	mp4

工作流

POST /v1/video/generations  →  task_id
轮询 GET /v1/video/generations/{task_id}  →  status
status = "succeeded" 后  →  下载视频 URL（有效期 24 小时）

示例

[!WARNING] 使用下方示例前必读。 通过 Upmore 网关（/v1/video/generations）调用时，本页示例的请求体不能直接使用：顶层的 content、duration、generate_audio、ratio 等属于网关封装字段，仅 model、prompt、images、seconds、metadata 会被处理。请参见通过 metadata 透传——那才是真正能到达模型的格式。

通过 `metadata` 透传

网关会把 metadata 内的所有字段原样透传给模型——这就是通过 Upmore 使用完整原生 Seedance 能力（首尾帧 role、时长、全部生成参数）的方式。发送 JSON 请求体：

{
  "model": "doubao-seedance-2-0",
  "prompt": "一只猫在阳光明媚的房间里弹钢琴，电影级光影",
  "metadata": {
    "content": [
      { "type": "image_url", "image_url": { "url": "https://example.com/first.png" }, "role": "first_frame" },
      { "type": "image_url", "image_url": { "url": "https://example.com/character.png" }, "role": "reference_image" },
      { "type": "image_url", "image_url": { "url": "https://example.com/last.png" }, "role": "last_frame" }
    ],
    "duration": 8,
    "resolution": "1080p",
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false,
    "seed": 42,
    "camera_fixed": false
  }
}

规则与避坑：

图片写在 metadata.content 并带 role，不要用顶层 images。 顶层 images 会以不带 role 的普通参考图转发，首尾帧锁定、角色参考在这条路径下不生效。传入 metadata.content 后会整体替换顶层 images——两者不要混用。
时长写在 metadata.duration。 顶层 duration 会被网关封装层丢弃，只有 metadata.duration（或顶层字符串形式的 seconds）能控制视频时长。只在顶层传 "duration": 45 会静默回退到模型默认时长。
提示词写在顶层 prompt 字段。 它会被注入为 content 数组中唯一的 text 项；metadata.content 里写的 text 项会被丢弃。metadata.model 会被忽略（透传前强制删除）。
必须用 JSON 请求体，不要用 multipart 表单——content 数组只有 JSON 形态才能正确往返。
return_last_frame 暂不可用：模型会生成尾帧，但网关轮询任务时只返回 video_url。
计费不受影响：分辨率档位、是否含视频输入的加价均从 metadata 读取，结算按模型回报的实际 token 用量重新计算。

文生视频

curl https://api.upmore.net/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "content": [
      {
        "type": "text",
        "text": "一只猫在阳光明媚的房间里弹钢琴，电影级光影"
      }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 8
  }'

import requests
import time

headers = {"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"}

# 步骤 1：创建任务
resp = requests.post(
    "https://api.upmore.net/v1/video/generations",
    headers=headers,
    json={
        "model": "doubao-seedance-2-0",
        "content": [
            {"type": "text", "text": "一只猫在阳光明媚的房间里弹钢琴，电影级光影"}
        ],
        "generate_audio": True,
        "ratio": "16:9",
        "duration": 8
    }
)
task_id = resp.json()["task_id"]

# 步骤 2：轮询结果
while True:
    result = requests.get(
        f"https://api.upmore.net/v1/video/generations/{task_id}",
        headers=headers
    ).json()
    status = result["data"]["status"]
    if status == "SUCCESS":
        print("视频 URL:", result["data"]["data"]["content"]["video_url"])
        break
    elif status == "FAILED":
        print("失败:", result["data"].get("fail_reason"))
        break
    time.sleep(5)

多模态参考（图片 + 视频 + 音频）

cURL

curl https://api.upmore.net/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "content": [
      {
        "type": "text",
        "text": "延长视频，一镜到底运镜，全程无剪辑断点，新年喜庆氛围感拉满"
      },
      {
        "type": "image_url",
        "image_url": {"url": "https://example.com/character.jpg"},
        "role": "reference_image"
      },
      {
        "type": "video_url",
        "video_url": {"url": "https://example.com/clip.mp4"},
        "role": "reference_video"
      },
      {
        "type": "audio_url",
        "audio_url": {"url": "https://example.com/bgm.mp3"},
        "role": "reference_audio"
      }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 11
  }'

编辑视频

cURL

curl https://api.upmore.net/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "content": [
      {
        "type": "text",
        "text": "将视频中的水替换成图片中的香水，运镜不变"
      },
      {
        "type": "image_url",
        "image_url": {"url": "https://example.com/perfume.jpg"},
        "role": "reference_image"
      },
      {
        "type": "video_url",
        "video_url": {"url": "https://example.com/original.mp4"},
        "role": "reference_video"
      }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 5
  }'

联网搜索增强（仅文生视频）

cURL

curl https://api.upmore.net/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "content": [
      {
        "type": "text",
        "text": "微距镜头对准树上鲜艳的花瓣，逐渐放大"
      }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 11,
    "tools": [{"type": "web_search"}]
  }'

请求参数

参数	类型	必填	说明
`model`	string	是	`doubao-seedance-2-0`
`content`	array	是	输入内容数组（text、image_url、video_url、audio_url）
`content[].type`	string	是	`text`、`image_url`、`video_url` 或 `audio_url`
`content[].text`	string	text 类型	文本提示词（建议中文 ≤500 字，英文 ≤1000 词）
`content[].image_url.url`	string	image 类型	图片 URL、Base64 或 `asset://<ID>`
`content[].video_url.url`	string	video 类型	视频 URL 或 `asset://<ID>`（mp4/mov，≤50 MB，2–15 秒）
`content[].audio_url.url`	string	audio 类型	音频 URL、Base64 或 `asset://<ID>`（wav/mp3，≤15 MB）
`content[].role`	string	条件必填	`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio`
`generate_audio`	boolean	否	生成同步音频，默认 `true`
`resolution`	string	否	`480p`、`720p` 或 `1080p`，默认 `720p`
`ratio`	string	否	`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`，默认 `adaptive`
`duration`	integer	否	4–15 秒，默认 `5`
`tools`	array	否	`[{"type": "web_search"}]` 启用联网搜索（仅文生视频）
`watermark`	boolean	否	是否添加水印，默认 `false`

[!NOTE] 上表是原生 Seedance 参数（放在 metadata 内携带）。通过网关封装调用时，每个参数都要以 metadata.<参数名> 的形式传入——例如 metadata.duration、metadata.content[].role，参见通过 metadata 透传。

输入模式

模式	内容项	`role` 取值
文生视频	1× text	—
图生视频（首帧）	text（可选）+ 1× image_url	`first_frame` 或不填
图生视频（首尾帧）	text（可选）+ 2× image_url	`first_frame` + `last_frame`
多模态参考	text（可选）+ 图片/视频/音频	`reference_image`、`reference_video`、`reference_audio`
编辑视频	text + image_url + video_url	`reference_image` + `reference_video`
延长视频	text + video_url(s)	`reference_video`

注意： 首帧、首尾帧、多模态参考为三种互斥场景，不可混用。

不同宽高比对应的宽高像素值

分辨率	16:9	4:3	1:1	3:4	9:16	21:9
480p	864x496	752x560	640x640	560x752	496x864	992x432
720p	1280x720	1112x834	960x960	834x1112	720x1280	1470x630
1080p	1920x1080	1664x1248	1440x1440	1248x1664	1080x1920	2208x944

API 参考

查看可交互的 API Playground。

快速开始

原生兼容端点

模型 API

核心能力

输出规格

工作流

示例

通过 `metadata` 透传

文生视频

多模态参考（图片 + 视频 + 音频）

编辑视频

联网搜索增强（仅文生视频）

请求参数

输入模式

不同宽高比对应的宽高像素值

API 参考

​核心能力

​输出规格

​工作流

​示例

​通过 metadata 透传

​文生视频

​多模态参考（图片 + 视频 + 音频）

​编辑视频

​联网搜索增强（仅文生视频）

​请求参数

​输入模式

​不同宽高比对应的宽高像素值

API 参考

核心能力

输出规格

工作流

示例

通过 `metadata` 透传

文生视频

多模态参考（图片 + 视频 + 音频）

编辑视频

联网搜索增强（仅文生视频）

请求参数

输入模式

不同宽高比对应的宽高像素值