Seedance 2.5

本页中的 {BASE_URL} 表示 https://api.uniall.ai。

更新时间：2026-08-12

概览

UniAll 对外提供一个稳定的 Seedance 2.5 公共模型：seedance2.5。该模型支持文生视频、单首帧和首尾帧生视频、多模态参考生成、视频编辑、视频延长、可复用 asset:// 素材，以及可选的联网搜索。

能力	必需输入	核心规则
文生视频	提示词	必须传入 resolution 和 duration。
单首帧生视频	1 张首帧图	省略 aspect_ratio 或设为 auto。
首尾帧生视频	1 张首帧图和 1 张尾帧图	省略 aspect_ratio 或设为 auto。
多模态参考生成	图片、视频或音频	文本可省略，也允许仅音频参考。
视频编辑	提示词和 1 个视频	必须传 operation: "edit_video" 和 duration: "auto"。
视频延长	提示词和 1 个视频	必须显式传 operation: "extend_video"。

接口与鉴权

操作	方法	路径
创建任务	POST	/v1/videos
查询任务	GET	/v1/videos/{task_id}
下载完成视频	GET	/v1/videos/{task_id}/content

已有客户端可继续使用以下兼容创建和查询路径：

POST /v1/videos/generations
POST /v1/video/generations
GET  /v1/videos/generations/{task_id}
GET  /v1/video/generations/{task_id}

新接入统一使用 /v1/videos 和 /v1/videos/{task_id}。

Authorization: Bearer sk-***
Content-Type: application/json

请求参数

参数	类型	必填	说明
model	string	是	固定为 seedance2.5。
resolution	string	是	480p 或 720p。
size	string	否	resolution 的兼容别名；两者同时存在时必须一致。
duration	integer/string	是	4 到 30 的整数，或 auto；不同操作还有额外限制。
prompt	string	条件必填	文本指令。文生、编辑和延长必填；仅媒体参考请求可省略。
aspect_ratio	string	否	auto、21:9、16:9、4:3、1:1、3:4 或 9:16。
ratio	string	否	aspect_ratio 的兼容别名；adaptive 会归一为 auto。
output_format	string	否	mp4 或 mov，默认 mp4；兼容客户端也可传 extra_body.output_format。
content	object[]	否	带明确角色的图片、视频和音频多模态输入。
operation	string	条件必填	edit_video 和 extend_video 必须显式传入；多模态参考需要传操作时使用 reference_to_video。
generate_audio	boolean	否	是否生成音频。
seed	integer	否	在支持的场景中控制随机变化。
watermark	boolean	否	是否添加水印。
return_last_frame	boolean	否	是否在可用时返回生成视频的尾帧。
tools	object[]	否	只接受 [{"type":"web_search"}]。

以下字段不属于 Seedance 2.5 公共契约，传入会被拒绝：draft、frames、camera_fixed 和 service_tier: "flex"。

最小文生请求

curl -X POST "{BASE_URL}/v1/videos" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.5",
    "prompt": "A cinematic city street after rain",
    "resolution": "720p",
    "duration": 8,
    "aspect_ratio": "16:9",
    "output_format": "mp4"
  }'

媒体输入

新接入建议使用 content[] 表达多模态输入。每一项包含一个媒体类型和明确角色。

项目类型	URL 字段	支持角色
image_url	image_url.url	first_frame、last_frame、reference_image
video_url	video_url.url	reference_video
audio_url	audio_url.url	reference_audio

媒体地址可以是公开 HTTP(S) URL，也可以是有效的 asset:// 素材地址。HTTP(S) 素材必须能由 UniAll 服务直接访问，不能依赖 Cookie 或自定义请求头。创建可复用 asset:// 输入的方法见 Seedance 素材库。

兼容字段 image、images、video、videos、audios 和 last_image 仍可使用。不要同时通过 content[] 和兼容字段传入冲突内容。

媒体数量限制

• 图片最多 30 张。
• 视频最多 10 个。
• 音频最多 10 个。
• 所有媒体合计最多 50 个。
• 多模态请求可以不包含文本。
• 允许仅音频参考请求。

操作规则

模式	operation	duration	aspect_ratio
文生视频	省略	auto 或整数 4..30	任意支持值
单首帧生视频	省略	auto 或整数 4..30	省略或 auto
首尾帧生视频	省略	auto 或整数 4..30	省略或 auto
多模态参考生成	需要传时使用 reference_to_video	auto 或整数 4..30	由媒体模式决定；帧输入只能使用 auto
视频编辑	必须为 edit_video	只能为 auto	省略或 auto
视频延长	必须为 extend_video	auto 或整数 4..30	省略或 auto

不要通过提示词关键词推断编辑或延长。两种请求都必须显式传入 operation。

请求示例

首尾帧生视频

{
  "model": "seedance2.5",
  "prompt": "Move naturally from the first composition to the last while preserving the subject.",
  "resolution": "720p",
  "duration": 10,
  "aspect_ratio": "auto",
  "content": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first.png"
      },
      "role": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/last.png"
      },
      "role": "last_frame"
    }
  ]
}

单首帧模式只传 first_frame 项。两种帧模式都不能使用固定画幅，因为画面构图由源图片决定。

多模态参考生成

{
  "model": "seedance2.5",
  "operation": "reference_to_video",
  "resolution": "720p",
  "duration": 12,
  "content": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/motion.mp4"
      },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://example.com/music.mp3"
      },
      "role": "reference_audio"
    }
  ]
}

视频编辑

{
  "model": "seedance2.5",
  "prompt": "Replace the sky and preserve the subject",
  "video": "https://example.com/source.mp4",
  "operation": "edit_video",
  "resolution": "720p",
  "duration": "auto",
  "aspect_ratio": "auto"
}

视频延长

{
  "model": "seedance2.5",
  "prompt": "Continue the camera movement into the illuminated square.",
  "video": "asset://mat_xxxxxxxxxxxxx",
  "operation": "extend_video",
  "resolution": "720p",
  "duration": 8,
  "aspect_ratio": "auto",
  "output_format": "mov"
}

联网搜索

{
  "model": "seedance2.5",
  "prompt": "Create a concise visual recap of the latest public spaceflight milestone.",
  "resolution": "720p",
  "duration": 8,
  "tools": [
    {
      "type": "web_search"
    }
  ]
}

联网搜索可以与媒体输入组合。其他 tools 结构不受支持。

创建响应与任务生命周期

{
  "id": "task_xxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "seedance2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1786492800
}

保存公开 id 或 task_id。建议每 2 到 5 秒调用一次 GET /v1/videos/{task_id}，当 status 变为 completed 或 failed 后停止。完成任务会返回公开结果 URL，也可以通过需要鉴权的 /v1/videos/{task_id}/content 获取文件。

公共状态字段、完成和失败响应示例、下载处理见视频生成概览。客户端只应使用 UniAll 文档公开的任务 ID、状态、结果、用量和错误字段。

计费说明

Seedance 2.5 按任务完成后的有效完成 Token 用量结算。预扣只是估算，最终金额以完成任务返回的有效 usage 和结算记录为准。

输入类型	每百万完成 Token 参考基础价
输入不包含视频	约 $10.294117647（70 CNY / 6.8）
输入包含视频	约 $6.176470588（42 CNY / 6.8）

• 480p 与 720p 使用相同的 Token 单价。
• 上述金额是完成 Token 参考价，不是每秒固定价格。
• 账号与分组价格会影响最终用户价格，以 UniAll 当前价格页和任务结算记录为准。

常见错误

错误	原因	处理方式
缺少参数	未传 resolution 或 duration	同时传入两个必填字段。
分辨率无效	传入 1080p、4k 或其他不支持值	使用 480p 或 720p。
兼容别名冲突	resolution 和 size 的值不同	删除 size 或确保两者完全一致。
编辑时长无效	edit_video 使用整数时长	把 duration 设为 auto。
画幅无效	首帧、首尾帧、编辑或延长请求使用固定比例	省略 aspect_ratio 或设为 auto。
媒体数量超限	单类型或媒体总数超过限制	按文档限制减少媒体数量。
素材不可访问	URL 私有、过期或无法从公网访问	使用稳定公开 URL 或可用的 asset:// 素材。
联网工具无效	tools 不是唯一支持的联网搜索结构	传 [{"type":"web_search"}] 或省略 tools。
字段不支持	传入 draft、frames、camera_fixed 或 service_tier: "flex"	删除不支持字段。

相关页面

• 视频生成概览
• Seedance 2.0
• Seedance 素材库
• 模型列表