视频生成：Seedance

Seedance 系列异步视频生成：模型与时长、POST /v1/video/generations 创建任务的参数、文生视频与图生视频示例、任务查询与注意事项。

Seedance 系列为异步视频生成模型，支持文生视频和图生视频。提交任务后返回 task_id，再轮询查询接口获取视频地址。

模型

模型	定位	时长（秒）	说明
`doubao-seedance-2-0-260128`	标准版	4~15，或 -1	通用视频生成
`doubao-seedance-2-0-fast-260128`	快速版	4~15，或 -1	生成更快，价格低于标准版
`doubao-seedance-2-0-mini-260615`	轻量版	4~15，或 -1	价格最低
`doubao-seedance-2-5-260628`	最新版	4~30，或 -1	支持 21:9、mov 输出和全模态参考生视频

价格见模型价格页。

创建任务

text

POST https://run.fluxlane.ai/v1/video/generations

顶层传 model、prompt，生成参数放在 metadata 中。

参数	类型	必选	说明
`model`	string	必选	模型名，见上表
`prompt`	string	必选	文本提示词，描述期望生成的画面内容、动作、风格
`images`	`array<string>`	可选	图生视频的输入图片 URL 列表
`seconds`	string	可选	视频时长（秒），如 `"10"`。与 `metadata.duration` 等效，同时传时以 `seconds` 为准
`metadata`	object	可选	生成参数，字段见下表

时长参数

时长请用 metadata.duration 或顶层 seconds 传入。顶层 duration 字段不生效，会按默认 5 秒生成。

metadata 字段

字段	类型	说明
`duration`	integer	视频时长（秒），默认 5。2.0 系列取 4~~15，2.5 取 4~~30；-1 表示由模型自动选择。超出范围返回 400。与 `frames` 二选一
`frames`	integer	视频帧数，取值范围 [29, 289] 内满足 25 + 4n 的整数；优先级高于 `duration`
`resolution`	string	分辨率：480p、720p、1080p、4k（取值随模型不同），默认 720p
`ratio`	string	宽高比：16:9、4:3、1:1、3:4、9:16、21:9、adaptive，默认 16:9
`seed`	integer	随机种子，默认 -1（随机），取值范围 [-1, 2147483647]
`generate_audio`	boolean	是否生成有声视频，默认 true。不需要声音时显式传 false
`watermark`	boolean	是否包含「AI 生成」水印，默认 false
`camera_fixed`	boolean	是否固定摄像头，默认 false
`return_last_frame`	boolean	是否返回生成视频的尾帧图像，默认 false
`output_format`	string	输出格式：mp4（默认）、mov（仅 2.5）
`omni_reference_task_type`	string	全模态参考生视频任务类型：auto（默认）、reference、edit、extend（仅 2.5）
`service_tier`	string	服务等级：default（在线推理，默认）、flex（离线推理）
`execution_expires_after`	integer	任务超时阈值（秒），默认 172800（48 小时），取值范围 [3600, 259200]
`priority`	integer	执行优先级，默认 0，取值范围 [0, 9]，数值越大越优先
`safety_identifier`	string	终端用户唯一标识符，英文字符串，不超过 64 个字符
`tools`	`array<object>`	工具配置，如 `[{"type": "web_search"}]` 开启联网搜索
`content`	`array<object>`	多模态输入（高级用法）。每项含 `type`（`image_url` / `video_url` / `audio_url`）、对应的 `{"url": "..."}` 对象（URL 或 base64 data URL），以及可选 `role`：`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio`。文本提示词用顶层 `prompt`，不要放进 `content`

文生视频

bash

curl https://run.fluxlane.ai/v1/video/generations \
  -H "Authorization: Bearer $FLUXLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "doubao-seedance-2-5-260628",
  "prompt": "一只猫咪在沙滩上奔跑，金色夕阳，慢动作镜头",
  "metadata": {
    "duration": 10,
    "resolution": "720p",
    "ratio": "16:9",
    "seed": 12345,
    "generate_audio": true,
    "watermark": false
  }
}'

图生视频（首帧）

bash

curl https://run.fluxlane.ai/v1/video/generations \
  -H "Authorization: Bearer $FLUXLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "镜头缓慢推进，花朵在风中轻轻摇曳",
  "images": ["https://example.com/first-frame.jpg"],
  "metadata": {"duration": 5, "resolution": "720p", "ratio": "adaptive"}
}'

提交成功返回：

json

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "model": "doubao-seedance-2-5-260628",
  "status": "queued",
  "created_at": 1793766739
}

查询任务

text

GET https://run.fluxlane.ai/v1/video/generations/{task_id}

建议每 3~5 秒轮询一次。只能查询当前 API Key 提交的任务。

bash

curl https://run.fluxlane.ai/v1/video/generations/task_xxx \
  -H "Authorization: Bearer $FLUXLANE_API_KEY"

字段	说明
`data.status`	QUEUED / IN_PROGRESS / SUCCESS / FAILURE
`data.progress`	进度百分比，如 `"50%"`
`data.fail_reason`	失败原因，成功时为空
`data.quota`	本次任务扣减的额度。任务失败时为 0，不扣费
`data.data.content.video_url`	生成视频的地址，有效期 24 小时。2.5 生成的视频地址最多下载 100 次
`data.data.content.last_frame_url`	尾帧图像地址，创建时传 `"return_last_frame": true` 才返回，有效期 24 小时
`data.data.duration` / `framespersecond`	实际时长（秒）/ 帧率
`data.data.resolution` / `ratio`	实际分辨率 / 宽高比
`data.data.seed`	本次使用的种子值
`data.data.generate_audio`	视频是否包含与画面同步的声音
`data.data.usage.completion_tokens`	生成视频消耗的 Token 数，可用于计费对账
`data.data.error`	失败时的错误码 `code` 与说明 `message`

成功示例：

json

{
  "code": "success",
  "data": {
    "task_id": "task_xxx",
    "status": "SUCCESS",
    "progress": "100%",
    "data": {
      "status": "succeeded",
      "content": {"video_url": "https://.../xxx.mp4?..."},
      "duration": 10,
      "framespersecond": 24,
      "resolution": "720p",
      "ratio": "16:9",
      "seed": 12345,
      "generate_audio": true,
      "usage": {"completion_tokens": 216900, "total_tokens": 216900}
    }
  }
}

注意事项

视频按生成的 Token 计费，Token 数随时长和分辨率增加。
视频地址有效期 24 小时，请及时下载转存。任务记录保留 7 天。
内容审核不通过时任务状态为 FAILURE，原因见 fail_reason，不扣费。修改提示词后重试。
结果中的 seed 仅标准版与 2.5 返回，fast 与 mini 不返回该字段；watermark 不在结果中返回。均不影响参数生效。

模型​

创建任务​

metadata 字段​

文生视频​

图生视频（首帧）​

查询任务​

注意事项​

模型

创建任务

metadata 字段

文生视频

图生视频（首帧）

查询任务

注意事项