Seedance 1.0 Pro - MixRoute API

Seedance 1.0 Pro 是 ByteDance 视频模型。请求使用完整路由 ID seedance-1-0-pro-250528，版本后缀属于 ID 的一部分。完整字段说明见 Seedance API。

模型参数与限制

设置	取值
`model`	`seedance-1-0-pro-250528`
输入方式	文本、首帧图像或首尾帧图像。
`metadata.content`	必填输入数组。文生视频须包含文本项，内容与顶层 prompt 保持一致。
`metadata.duration`	2-12 秒；不支持 -1。
`metadata.resolution`	`480p`, `720p`, `1080p`；默认 1080p。
`metadata.ratio`	`21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `adaptive`
音频	输出无声视频，不传 generate_audio。
格式	`mp4`
帧率	24 fps

顶层保留 model、prompt、asset；全部厂商字段放入 metadata。媒体输入示例设置 asset=true。
首尾帧角色与 reference_* 角色属于不同输入方式，不要混用。
此旧版本不支持视频参考、音频参考或 reference_image 输入，只使用上表列出的帧图像输入方式；调用前先确认账户是否仍提供该模型 ID。
文生视频默认 16:9，不能使用 adaptive；图生视频默认 adaptive。

调用示例

先设置 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": "seedance-1-0-pro-250528",
  "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",
    "watermark": false
  }
}'

Python

import json
import os
import requests

payload = json.loads(r'''
{
  "model": "seedance-1-0-pro-250528",
  "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",
    "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": "seedance-1-0-pro-250528",
  "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",
    "watermark": false
  }
}'

任务结果

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