Doubao Seedance 2.5 - MixRoute API

Doubao Seedance 2.5 是 ByteDance 视频模型。请求使用完整路由 ID doubao-seedance-2-5-260628，版本后缀属于 ID 的一部分。完整字段说明见 Doubao API。

模型参数与限制

设置	取值
`model`	`doubao-seedance-2-5-260628`
输入方式	文本、首帧图像、首尾帧图像或全模态参考。
`metadata.content`	必填输入数组。文生视频须包含文本项，内容与顶层 prompt 保持一致。
`metadata.duration`	4-30 / -1 秒；-1 自动选择时长。
`metadata.resolution`	`480p`, `720p`, `1080p`；默认 720p。
`metadata.ratio`	`21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `adaptive`
音频	`metadata.generate_audio` 默认 true；false 输出无声视频。
格式	`metadata.output_format`: `mp4` (default), `mov`
帧率	24 fps

顶层保留 model、prompt、asset；全部厂商字段放入 metadata。媒体输入示例设置 asset=true。
首尾帧角色与 reference_* 角色属于不同输入方式，不要混用。
默认比例为 adaptive。首帧、首尾帧、编辑和延长场景必须使用 adaptive；编辑须使用 duration=-1，并提供 4-30 秒源视频。
全模态参考最多包含 30 张图、10 个视频和 10 个音频，支持仅音频参考。

调用示例

先设置 MIXROUTE_API_KEY，并将图像、视频、音频占位地址替换为可访问的源素材。

文生视频

curl --request POST "https://api.mixroute.ai/v1/video/generations" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "doubao-seedance-2-5-260628",
  "prompt": "A ceramic mug slowly rotates on a white tabletop in soft daylight.",
  "asset": false,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A ceramic mug slowly rotates on a white tabletop in soft daylight."
      }
    ],
    "duration": 4,
    "resolution": "480p",
    "ratio": "1:1",
    "generate_audio": false,
    "watermark": false
  }
}'

Python

import json
import os
import requests

payload = json.loads(r'''
{
  "model": "doubao-seedance-2-5-260628",
  "prompt": "A ceramic mug slowly rotates on a white tabletop in soft daylight.",
  "asset": false,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A ceramic mug slowly rotates on a white tabletop in soft daylight."
      }
    ],
    "duration": 4,
    "resolution": "480p",
    "ratio": "1:1",
    "generate_audio": false,
    "watermark": false
  }
}
''')
response = requests.post(
    "https://api.mixroute.ai/v1/video/generations",
    headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]},
    json=payload,
    timeout=60,
)
response.raise_for_status()
result = response.json()
if result.get("code") not in (None, 0, 200, "0", "200", "success"):
    raise RuntimeError(result.get("message") or result)
print(result)

首帧图生视频

curl --request POST "https://api.mixroute.ai/v1/video/generations" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "doubao-seedance-2-5-260628",
  "prompt": "A ceramic mug slowly rotates on a white tabletop in soft daylight.",
  "asset": true,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A ceramic mug slowly rotates on a white tabletop in soft daylight."
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/first-frame.png"
        },
        "role": "first_frame"
      }
    ],
    "duration": 4,
    "resolution": "480p",
    "ratio": "adaptive",
    "generate_audio": false,
    "watermark": false
  }
}'

任务结果

保存提交返回的 MixRoute 任务 ID，使用查询视频任务轮询；任务成功后再读取视频 URL，提交成功不代表视频已经生成完成。