SeeDance 视频生成

通过 TENSORAXIS 调用火山方舟 Doubao Seedance 系列：文生视频、图生视频、首尾帧与视频参考/续写，以及 metadata 高级参数与计费说明。

SeeDance 是火山方舟（Volcengine Ark）Doubao Seedance 系列视频模型在 TENSORAXIS 上的接入，渠道 doubao-video。和所有视频模型一样，它是异步任务：先提交任务取得 task_id，再轮询任务状态，完成后读取视频地址。提交与查询的通用流程见视频生成总览，本页只讲 SeeDance 特有的能力与参数。

请使用本站入口字段 prompt、images 和 metadata，由 TENSORAXIS 转换为火山方舟内容生成任务格式。不要把火山官方示例中的顶层 content[] 请求体直接发给 /v1/video/generations，否则会因缺少 prompt 返回 400 prompt is required。

模型与能力矩阵

模型	文生视频	图生视频（首帧）	首尾帧	多模态参考（图/视频/音频）	原生音频
`doubao-seedance-1-0-lite-t2v`	✅	—	—	—	—
`doubao-seedance-1-0-lite-i2v`	—	✅	—	—	—
`doubao-seedance-1-0-pro-250528`	✅	✅	—	—	—
`doubao-seedance-1-5-pro-251215`	✅	✅	—	—	—
`doubao-seedance-2-0-260128`	✅	✅	✅	✅	✅
`doubao-seedance-2-0-fast-260128`	✅	✅	✅	✅	✅

2-0-fast 与 2-0 能力一致，主打更快出图。能力支持以上游模型实际返回为准。

本站入口字段

POST /v1/video/generations

字段	类型	必填	说明
`model`	string	是	SeeDance 模型名，见上表
`prompt`	string	是	视频提示词；为空返回 `400 prompt is required`
`images`	string[]	否	参考图 URL，用于图生视频（首帧）；多张参考图也走这里
`image`	string	否	单张参考图 URL；`images` 为空时服务端会兼容转换为 `images`
`seconds`	string	否	时长（秒）；正整数会转成上游 `duration`，等价于 `metadata.duration`
`metadata`	object	否	SeeDance 高级参数，见下方 metadata 高级参数

文生视频

仅提供 prompt，可在 metadata 中补充分辨率、时长、画面比例等参数。

curl https://api.tensoraxis.com/v1/video/generations \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "戴帽子的老爷爷微笑往前走，背景是秋天的街道",
    "metadata": {
      "resolution": "1080p",
      "ratio": "16:9",
      "duration": 5
    }
  }'

图生视频

首帧图生

通过 images 传入参考图，作为视频首帧；其余参数同文生视频。

curl https://api.tensoraxis.com/v1/video/generations \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-0-lite-i2v",
    "prompt": "镜头缓慢拉近，人物微笑",
    "images": ["https://example.com/first-frame.jpg"],
    "metadata": {
      "resolution": "1080p",
      "duration": 5
    }
  }'

首尾帧（Seedance 2.0）

首尾帧需要用 metadata.content 显式给每张图标注 role（first_frame / last_frame），它会覆盖由 images 生成的内容列表。结构见 metadata.content 结构。

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "从清晨到日落的延时变化",
  "metadata": {
    "resolution": "1080p",
    "duration": 5,
    "content": [
      { "type": "image_url", "image_url": { "url": "https://example.com/start.jpg" }, "role": "first_frame" },
      { "type": "image_url", "image_url": { "url": "https://example.com/end.jpg" }, "role": "last_frame" }
    ]
  }
}

视频参考 / 续写（等价「视频编辑」）

SeeDance 后端没有独立的逐帧视频编辑端点。Seedance 2.0 的「视频多模态参考」能力允许把一段视频作为输入参考/续写来源——通过 metadata.content 传入带 video_url 的条目即可。

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "延续这段视频的运动，镜头继续向右平移",
  "metadata": {
    "resolution": "1080p",
    "content": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }
}

当请求带视频输入时，TENSORAXIS 会按真实媒体内容（而非 metadata 声明）判定为「视频输入」类型并归入更优惠的计费档，见计费说明。如果你需要的是逐帧式视频编辑（替换/重绘指定片段），请改用 HappyHorse 视频编辑（happyhorse-1.0-video-edit）。

metadata 高级参数

metadata 下的字段会映射为火山方舟任务的顶层字段。下表「取值范围 / 默认值」来自火山方舟官方说明，以上游对应模型实际返回为准；TENSORAXIS 只负责接收并转发这些字段。

字段	转发为	类型	取值范围 / 默认	说明
`resolution`	`resolution`	string	`480p` / `720p` / `1080p` / `2k`，默认 `1080p`	输出分辨率
`ratio`	`ratio`	string	`16:9` / `9:16` / `4:3` / `3:4` / `21:9` / `1:1` / `adaptive`	画面比例
`duration`	`duration`	integer	`4`–`15`，默认 `5`	视频时长（秒）；与顶层 `seconds` 等价
`frames`	`frames`	integer	由模型决定	总帧数（与帧率/时长相关）
`seed`	`seed`	integer	随机种子	固定随机性以复现结果
`camera_fixed`	`camera_fixed`	boolean	默认 `false`	是否固定镜头
`watermark`	`watermark`	boolean	默认 `false`	是否添加水印
`generate_audio`	`generate_audio`	boolean	默认 `false`	是否生成原生音频（Seedance 2.0）
`return_last_frame`	`return_last_frame`	boolean	默认 `false`	是否返回末帧图
`draft`	`draft`	boolean	默认 `false`	草稿/预览模式
`service_tier`	`service_tier`	string	由模型决定	服务等级
`execution_expires_after`	`execution_expires_after`	integer	由模型决定	任务过期时间（秒）
`callback_url`	`callback_url`	string	—	任务完成回调地址
`tools`	`tools`	array	—	工具配置（如联网搜索）
`content`	`content`	array	—	高级内容数组，见下节

注意事项：

metadata.model 会被移除，不能用它覆盖计费模型。
未映射到上述字段的 metadata 键通常不会转发给上游。
同时传 seconds 与 metadata.duration 时，以 metadata.duration 为准。

metadata.content 结构

metadata.content 是高级内容数组，用于首尾帧、视频参考、音频参考等场景。一旦提供，它会覆盖由 images 生成的内容列表（其中 type: text 的条目会被忽略，正文以 prompt 为准）。

条目类型	字段	官方约束（以上游为准）
`image_url`	`image_url.url`、可选 `role`	图片 ≤30MB，≤9 张；`role` 用于首尾帧
`video_url`	`video_url.url`	视频 2–15s，≤3 段
`audio_url`	`audio_url.url`	音频 ≤15MB，≤3 段
`text`	`text`	会被忽略，正文以顶层 `prompt` 为准

计费说明

SeeDance 按 token 计费，分辨率已体现在 token 数量中，不另收分辨率系数。

普通生成（文生 / 图生）归 generate 档。
带视频输入（视频参考/续写）按真实媒体内容判定，归入更优惠的 video_input 折扣档（单价低于普通生成）。

具体单价以控制台「视频计价」配置与定价页为准；运营可按最新官方价覆盖默认值。

任务查询

提交、轮询、状态码、OpenAI/Sora 兼容查询路径等通用流程，见视频生成总览。

On this page