Seedance 2.5 视频生成 API

Seedance 2.5 支持文生视频、首帧或首尾帧生成、多模态参考生成和视频延长，并可生成同步音轨。Mozia API 使用统一的异步视频接口：先提交任务，再轮询状态并下载结果。

接口总览

方法	路径	作用
POST	/v1/video/generations	提交视频生成任务
GET	/v1/video/generations/{task_id}	查询任务状态、进度与结果
GET	/v1/video/generations/{task_id}/content	下载生成的视频

基础地址：https://mzsjai.com

所有请求都需要 API Key：

Authorization: Bearer <YOUR_API_KEY>

模型

模型 ID	固定分辨率	适用场景
doubao/seedance-2.5-pro-720p	720p	成本与清晰度均衡
doubao/seedance-2.5-pro-1080p	1080p	更高清晰度输出

分辨率由模型 ID 决定。调用时可以省略 resolution；即使传入该字段，平台仍会使用模型 ID 对应的固定分辨率。需要切换清晰度时，请更换模型 ID。

实际可用模型以账号调用 GET /v1/models 后返回的列表为准。最新单价请查看模型价格。

快速开始

下面的示例提交一个 8 秒、16:9、带音轨的 1080p 文生视频任务：

curl --fail-with-body \
  -X POST 'https://mzsjai.com/v1/video/generations' \
  -H "Authorization: Bearer ${MOZIA_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao/seedance-2.5-pro-1080p",
    "prompt": "雪后的清晨，一只穿红色大衣的猫走过安静街道，镜头平稳跟随，电影质感",
    "duration": 8,
    "ratio": "16:9",
    "generate_audio": true
  }'

提交成功后请保存返回的 task_id：

{
  "id": "task_a1b2c3d4",
  "task_id": "task_a1b2c3d4",
  "object": "video",
  "model": "doubao/seedance-2.5-pro-1080p",
  "status": "queued",
  "progress": 0,
  "created_at": 1780000000
}

请求参数

参数	类型	必填	说明
model	string	是	使用上表中的完整模型 ID
prompt	string	是	画面、动作、镜头、声音或延长意图
duration	integer	是	视频时长，支持 4～30 秒的正整数
ratio	string	否	21:9、16:9、4:3、1:1、3:4、9:16 或 adaptive
images	array	否	首帧、尾帧或参考图片
videos	array	否	参考视频
audios	array	否	参考音频
generate_audio	boolean	否	是否生成音轨
omni_reference_task_type	string	否	参考任务类型，常用值为 auto 或 extend
output_format	string	否	mp4 或 mov，默认 mp4
watermark	boolean	否	是否添加水印
return_last_frame	boolean	否	是否在结果中返回尾帧图片
web_search	boolean	否	是否允许联网搜索辅助生成
seed	integer	否	随机种子
camera_fixed	boolean	否	是否尽量固定镜头

当前平台要求显式传入顶层 prompt 和正整数 duration。请勿仅在 content 中放置提示词，也不要使用 duration: -1。依赖自动时长的编辑模式目前不属于稳定开放能力。

素材必须是模型服务可访问的公网 HTTP(S) URL，不支持 Data URL、原始 Base64、本地路径或内网地址。

本地文件可以先通过平台素材上传接口转换为公网地址，再用于 images、videos 或 audios。

首帧和首尾帧生成

图片项使用 {url, role} 格式。支持的角色为：

role	说明
first_frame	视频首帧
last_frame	视频尾帧，必须同时提供首帧
reference_image	人物、主体、服装、风格或场景参考

首帧或首尾帧生成需要使用 ratio: "adaptive"。首尾帧示例：

curl --fail-with-body \
  -X POST 'https://mzsjai.com/v1/video/generations' \
  -H "Authorization: Bearer ${MOZIA_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao/seedance-2.5-pro-720p",
    "prompt": "画面从晴朗日出自然过渡到雷雨，女孩转身看向镜头，环绕运镜",
    "images": [
      {"url": "https://example.com/first.png", "role": "first_frame"},
      {"url": "https://example.com/last.png", "role": "last_frame"}
    ],
    "ratio": "adaptive",
    "duration": 6,
    "generate_audio": true
  }'

只使用首帧时，移除 last_frame 项即可。首帧、尾帧不能与参考图片、参考视频或参考音频混用。

多模态参考生成

Seedance 2.5 可以组合参考图片、参考视频和参考音频。参考素材用于约束人物、外观、动作、镜头、节奏或声音：

curl --fail-with-body \
  -X POST 'https://mzsjai.com/v1/video/generations' \
  -H "Authorization: Bearer ${MOZIA_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao/seedance-2.5-pro-1080p",
    "prompt": "保持参考图中的人物外观，采用参考视频的动作节奏，并让画面变化贴合参考音频",
    "images": [
      {"url": "https://example.com/character.png", "role": "reference_image"}
    ],
    "videos": [
      {"url": "https://example.com/motion.mp4", "role": "reference_video"}
    ],
    "audios": [
      {"url": "https://example.com/rhythm.mp3", "role": "reference_audio"}
    ],
    "ratio": "16:9",
    "duration": 12,
    "generate_audio": true,
    "omni_reference_task_type": "auto"
  }'

可以只传一种参考素材，也可以组合使用；纯音频参考同样可用。单个任务最多可包含 50 项参考素材，其中图片不超过 30 项、视频不超过 10 项、音频不超过 10 项。参考视频建议控制在 4～30 秒。

视频延长

延长视频时传入一个 reference_video，并将 omni_reference_task_type 设为 extend：

curl --fail-with-body \
  -X POST 'https://mzsjai.com/v1/video/generations' \
  -H "Authorization: Bearer ${MOZIA_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao/seedance-2.5-pro-1080p",
    "prompt": "延续现有故事，人物继续走入街道，保持原有画面风格和镜头运动",
    "videos": [
      {"url": "https://example.com/clip.mp4", "role": "reference_video"}
    ],
    "ratio": "adaptive",
    "duration": 10,
    "generate_audio": true,
    "omni_reference_task_type": "extend",
    "output_format": "mov"
  }'

延长任务需要使用 ratio: "adaptive"。duration 仍须设置为 4～30 秒的正整数，提示词中应明确使用“延长”“延续”或“续写”等意图。

查询和下载

建议每 5～10 秒查询一次任务状态：

curl --fail-with-body \
  'https://mzsjai.com/v1/video/generations/task_a1b2c3d4' \
  -H "Authorization: Bearer ${MOZIA_API_KEY}"

当 status 变为 succeeded 后，可以使用响应中的 content.url，也可以通过统一下载接口获取文件：

curl --fail-with-body -L \
  'https://mzsjai.com/v1/video/generations/task_a1b2c3d4/content' \
  -H "Authorization: Bearer ${MOZIA_API_KEY}" \
  -o result.mp4

status	说明
queued	已创建或正在排队
running	正在生成
succeeded	生成成功
failed	生成失败
cancelled	已取消
expired	已过期

完整的任务响应、错误处理和旧接口迁移说明请参阅视频生成。

素材上传

Seedance 2.5 的首帧、尾帧、参考图、参考视频和参考音频都需要模型可访问的公网 HTTP(S) 地址。本地文件上传、URL 导入、成功响应和错误处理说明请参阅视频素材上传。上传成功后，将返回的 file_url 填入 images、videos 或 audios 对应素材项的 url。

接入建议

• 将 API Key 保存在服务端，不要写入浏览器代码、公开仓库或日志。
• 视频任务耗时较长，请设置合理的总等待时间，并限制轮询频率。
• 对 502、503 和 504 使用指数退避进行有限重试；参数错误不要直接重试。
• content.url 可能具有有效期，任务成功后应及时下载并保存结果。