Seedance 2.5 视频生成 API 文档

概述

Seedance 2.5 Oversea 是新一代旗舰视频生成接口，支持文本、图片、视频、音频等多模态输入生成视频，在画面质量、镜头稳定性和多模态理解上较上一代显著提升。

特性：
- 🎬 旗舰画质：新一代模型，画面细节、动态表现与镜头稳定性全面升级
- 🧠 更强多模态理解：更精准地融合图片、视频、音频等参考素材
- 🔊 默认生成音频：generateAudio 默认开启，一步生成带声画的视频
- 🌍 海外加速：专为海外用户优化的访问速度

限制：
- ⚠️ 分辨率限制：支持 480p / 720p / 1080p，不支持 4K

Base URL: https://api.apiverse.ai（海外加速）

认证方式

所有接口均需要在请求头中携带 Token 进行认证：

Authorization: Bearer {YOUR_AUTH_TOKEN}

支持的使用场景

场景1：文生视频

纯文本描述生成视频，结果具有较大随机性。

curl -X POST "https://api.apiverse.ai/api/v2/open/aigc/seedance2-5-oversea" \
  -H "Authorization: Bearer your_auth_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": [
      {
        "type": "text",
        "text": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠"
      }
    ],
    "ratio": "16:9",
    "duration": 5,
    "resolution": "720p",
    "generateAudio": true
  }'

场景2：首帧/尾帧图片生视频

传入首帧或尾帧图片，模型基于图片内容生成视频。

curl -X POST "https://api.apiverse.ai/api/v2/open/aigc/seedance2-5-oversea" \
  -H "Authorization: Bearer your_auth_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": [
      {
        "type": "text",
        "text": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/fox_girl.png"
        },
        "role": "first_frame"
      }
    ],
    "ratio": "16:9",
    "duration": 5,
    "resolution": "720p"
  }'

场景3：多图参考生视频

传入多张参考图片，在提示词中通过 "图片1"、"图片2" 引用（最多9张）。

curl -X POST "https://api.apiverse.ai/api/v2/open/aigc/seedance2-5-oversea" \
  -H "Authorization: Bearer your_auth_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": [
      {
        "type": "text",
        "text": "[图片1]戴着眼镜穿着蓝色T恤的男生和[图片2]的柯基小狗，坐在[图片3]的草坪上，视频卡通风格"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/boy.png" },
        "role": "reference_image"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/dog.png" },
        "role": "reference_image"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/grass.png" },
        "role": "reference_image"
      }
    ],
    "ratio": "16:9",
    "duration": 5,
    "resolution": "720p"
  }'

场景4：多模态参考生成（图片+视频+音频）

同时参考图片、视频和音频素材进行视频生成。

该场景建议显式传 "omniReferenceTaskType": "reference"：不传时因含参考视频会被自动推断为 auto（等效视频编辑，强制 ratio=adaptive、duration=-1），传入的 ratio / duration 将不生效。详见任务类型 (omniReferenceTaskType)。

curl -X POST "https://api.apiverse.ai/api/v2/open/aigc/seedance2-5-oversea" \
  -H "Authorization: Bearer your_auth_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": [
      {
        "type": "text",
        "text": "以图片1为首帧，全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/pic1.jpg"
        },
        "role": "reference_image"
      },
      {
        "type": "video_url",
        "video_url": {
          "url": "https://example.com/video1.mp4"
        },
        "role": "reference_video"
      },
      {
        "type": "audio_url",
        "audio_url": {
          "url": "https://example.com/audio1.mp3"
        },
        "role": "reference_audio"
      }
    ],
    "omniReferenceTaskType": "reference",
    "ratio": "16:9",
    "duration": 11,
    "resolution": "720p",
    "generateAudio": true
  }'

场景5：编辑视频

替换视频中的主体、局部画面重绘/修复等。

curl -X POST "https://api.apiverse.ai/api/v2/open/aigc/seedance2-5-oversea" \
  -H "Authorization: Bearer your_auth_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": [
      {
        "type": "text",
        "text": "将视频1中的房子外立面墙壁刷成蓝色，天气改为雪天"
      },
      {
        "type": "video_url",
        "video_url": {
          "url": "https://example.com/house_video.mp4"
        },
        "role": "reference_video"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/snow_scene.jpg"
        },
        "role": "reference_image"
      }
    ],
    "ratio": "16:9",
    "duration": 5,
    "resolution": "720p"
  }'

查询任务状态

curl -X GET "https://api.apiverse.ai/api/v2/open/aigc/{taskId}" \
  -H "Authorization: Bearer your_auth_token_here"

接口详情

1. 创建 Seedance 2.5 Oversea 任务

POST /api/v2/open/aigc/seedance2-5-oversea

创建一个 Seedance 2.5 Oversea 视频生成任务。

Content-Type: application/json

请求参数

参数	类型	必填	说明
content	array	是	内容数组，详见下方 content 内容项
omniReferenceTaskType	string	否	任务类型：`auto` / `reference` / `edit` / `extend`。不传时由系统按输入素材自动推断，详见下方任务类型 (omniReferenceTaskType)
ratio	string	否	宽高比：`16:9`(默认) / `9:16` / `1:1` / `4:3` / `3:4` / `21:9` / `adaptive`。部分任务类型会强制为 `adaptive`，详见任务类型说明
duration	int	否	视频时长（秒），范围 4~30，或 `-1`（智能时长，由系统自动决定输出时长），默认 5。部分任务类型会强制为 `-1`，详见任务类型说明
resolution	string	否	输出分辨率：`480p` / `720p`(默认) / `1080p`
generateAudio	bool	否	是否生成音频，默认 `true`
watermark	bool	否	是否带水印，默认 `false`
seed	int	否	随机种子，用于复现结果
cameraFixed	bool	否	是否固定摄像头
returnLastFrame	bool	否	是否返回视频尾帧图片URL（已弃用）
outputFormat	string	否	输出视频容器格式：`mp4`(默认) / `mov`。不传即输出 mp4
webSearch	bool	否	是否启用在线搜索
nsfwChecker	bool	否	内容过滤开关，默认 `false`
realPersonMode	bool	否	真人模式开关，默认 `true`
callbackUrl	string	否	任务完成后的回调通知 URL

content 内容项

content 为数组，每个元素为一个内容项：

类型	字段	说明
text	`type`: "text", `text`: "提示词"	必须，视频描述提示词（3-20000字符）
image_url	`type`: "image_url", `image_url`: {"url": "URL"}, `role`: 见下方	参考图片（最多9张，支持jpeg/png/webp/bmp/tiff/gif，宽高比0.4-2.5，尺寸300-6000px，最大30MB）
video_url	`type`: "video_url", `video_url`: {"url": "URL"}, `role`: "reference_video"	参考视频（最多3个，mp4/mov，480p/720p，2-15秒，最大50MB，24-60FPS）
audio_url	`type`: "audio_url", `audio_url`: {"url": "URL"}, `role`: "reference_audio"	参考音频（最多3个，wav/mp3，2-15秒，最大15MB）

image_url 的 role 取值

role 值	说明
`reference_image`	参考图片
`first_frame`	首帧图片
`last_frame`	尾帧图片

说明：
- content 数组中必须包含至少一个 text 类型的内容项作为提示词
- 在提示词中通过 "图片1"、"图片2"、"视频1"、"音频1" 引用对应位置的参考素材
- 参考图片最多9张，参考视频最多3个（总时长不超过15秒），参考音频最多3个（总时长不超过15秒）
- 输入包含视频时，计费价格与纯文本/图片输入不同
- 支持 480p / 720p / 1080p 分辨率
- generateAudio 默认为 true（海外版本特性）
- realPersonMode 默认为 true，开启真人模式优化

响应参数

参数	类型	说明
code	int	状态码，0 表示成功
msg	string	状态信息
data.taskId	string	任务 ID，用于查询任务状态
data.status	string	任务状态，创建时固定为 `processing`
data.createdAt	string	创建时间

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "taskId": "task_20260508150000_abc12345",
    "status": "processing",
    "createdAt": "2026-05-08 15:00:00"
  }
}

2. 查询任务状态

GET /api/v2/open/aigc/{taskId}

查询单个任务的执行状态。

路径参数

参数	类型	必填	说明
taskId	string	是	任务 ID

响应参数

参数	类型	说明
code	int	状态码，0 表示成功
msg	string	状态信息
data.taskId	string	任务 ID
data.status	string	任务状态：`processing` / `success` / `failed`
data.result	string[]	生成的视频 URL 列表（成功时返回）
data.errorMsg	string	错误信息（失败时返回）
data.progress	int	任务进度，0 ~ 100
data.pointConsume	string	实际消费点数（decimal 字符串）
data.createdAt	string	创建时间
data.updatedAt	string	更新时间
data.completionTokens	int	实际 token 用量（仅按 token 计费的任务在结算完成后返回；按秒计费或尚未结算时不返回该字段）
data.output	object	任务的完整生成参数与结果对象（`succeeded` 且有对应信息时返回，字段见下方 data.output 字段）

data.output 字段

data.output 汇总了本次生成的实际参数与结果，各字段仅在有对应信息时返回（omitempty，有值才出现），请按「字段可能不存在」的方式做兼容解析。

参数	类型	说明
data.output.id	string	任务 ID
data.output.model	string	模型名称
data.output.status	string	任务状态：`submitted` / `running` / `succeeded` / `failed`
data.output.content.video_url	string	生成的视频 URL（`succeeded` 时返回）
data.output.content.last_frame_url	string	尾帧图片 URL（请求了尾帧且上游返回时才有）
data.output.duration	int	视频时长（秒）
data.output.frames_per_second	float	帧率
data.output.generate_audio	bool	是否生成同步音频
data.output.output_format	string	输出格式：`mp4` / `mov`
data.output.ratio	string	宽高比
data.output.resolution	string	分辨率
data.output.seed	int	随机种子
data.output.service_tier	string	服务档位
data.output.draft	bool	是否草稿（样片）模式
data.output.execution_expires_after	int	任务执行超时（秒）
data.output.usage.completion_tokens	int	生成 token 数
data.output.usage.prompt_tokens	int	提示 token 数（上游返回时才出现）
data.output.usage.total_tokens	int	总 token 数（上游返回时才出现）

响应示例

处理中

{
  "code": 0,
  "msg": "success",
  "data": {
    "taskId": "task_20260508150000_abc12345",
    "status": "processing",
    "createdAt": "2026-05-08 15:00:00",
    "updatedAt": "2026-05-08 15:00:05"
  }
}

成功

{
  "code": 0,
  "msg": "success",
  "data": {
    "taskId": "task_20260508150000_abc12345",
    "status": "success",
    "result": [
      "https://fc-gw-sh.oss-accelerate.aliyuncs.com/videos/2026/05/08/output.mp4"
    ],
    "progress": 100,
    "pointConsume": "0.5400",
    "createdAt": "2026-05-08 15:00:00",
    "updatedAt": "2026-05-08 15:03:30",
    "completionTokens": 108000,
    "output": {
      "id": "task_20260508150000_abc12345",
      "model": "seedance-2-5-oversea",
      "status": "succeeded",
      "content": {
        "video_url": "https://fc-gw-sh.oss-accelerate.aliyuncs.com/videos/2026/05/08/output.mp4"
      },
      "duration": 5,
      "frames_per_second": 24,
      "generate_audio": true,
      "output_format": "mp4",
      "ratio": "16:9",
      "resolution": "720p",
      "seed": 123456,
      "service_tier": "default",
      "usage": {
        "completion_tokens": 108000,
        "total_tokens": 108000
      }
    }
  }
}

说明：data.output 汇总了本次生成的实际参数与结果，其中各字段仅在有对应信息时返回。usage.prompt_tokens / usage.total_tokens 与 content.last_frame_url 仅在上游返回对应数据时才出现，请按「字段可能不存在」的方式做兼容解析。

说明：completionTokens 为上游返回的实际 token 用量，仅在【按 token 计费】的任务结算完成后返回。按秒计费的任务、以及尚未结算完成的任务不会返回该字段。使用智能时长（duration=-1）时强制按 token 计费，可用该字段核对实际用量。

失败

{
  "code": 0,
  "msg": "success",
  "data": {
    "taskId": "task_20260508150000_abc12345",
    "status": "failed",
    "errorMsg": "视频生成失败，请重试",
    "createdAt": "2026-05-08 15:00:00",
    "updatedAt": "2026-05-08 15:02:00"
  }
}

3. 批量查询任务状态

POST /api/v2/open/aigc/batch

批量查询多个任务的执行状态（最多 100 个）。

请求参数

参数	类型	必填	说明
taskIds	string[]	是	任务 ID 列表，最多 100 个

请求示例

{
  "taskIds": ["task_20260508150000_abc12345", "task_20260508150200_def67890"]
}

回调通知

当任务完成（成功或失败）时，如果创建任务时提供了 callbackUrl，系统会向该 URL 发送 POST 请求。

回调请求

Headers

Content-Type: application/json
X-Funcloud-Event: task.completed
X-Funcloud-Signature: {签名}

Body

{
  "event": "task.completed",
  "taskId": "task_20260508150000_abc12345",
  "status": "success",
  "result": ["https://fc-gw-sh.oss-accelerate.aliyuncs.com/videos/output.mp4"],
  "errorMsg": "",
  "timestamp": "2026-05-08T15:03:30+08:00",
  "signature": "a1b2c3d4e5f6..."
}

参数取值范围

分辨率 (resolution)

值	说明
`480p`	低清
`720p`	默认，推荐
`1080p`	高清

注意：Seedance 2.5 Oversea 不支持 4K

宽高比 (ratio)

值	说明
`16:9`	横屏（默认）
`9:16`	竖屏
`1:1`	方形
`4:3`	标准横屏
`3:4`	标准竖屏
`21:9`	超宽屏
`adaptive`	自适应（根据输入图片比例）

时长 (duration)

范围：4 ~ 30 秒
智能时长：传 -1 由系统自动决定输出时长（仅按 token 计费模式支持；按秒计费模式请指定具体秒数）
默认：5 秒

任务类型 (omniReferenceTaskType)

omniReferenceTaskType 用于声明本次生成的任务类型。不同任务类型对 ratio / duration 有不同的约束规则，且对所需素材有不同要求。不传 omniReferenceTaskType 时，系统按输入素材自动推断：带参考视频（video_url）→ auto；否则含首帧/尾帧图片或参考图片 → reference；否则 → reference。

omniReferenceTaskType	说明	素材要求	ratio	duration
`auto`	自动：带参考视频时等效视频编辑	无强制	推荐 `adaptive`（带参考视频时强制）	推荐 `-1`（带参考视频时强制）
`reference`	文本 / 参考图片 / 首尾帧生成视频	无强制	可自定义	可自定义（4~30 或 -1）
`edit`	视频编辑：基于参考视频生成	必须含参考视频	强制 `adaptive`（跟随输入）	强制 `-1`（跟随输入视频）
`extend`	视频延长	必须含参考视频	强制 `adaptive`（跟随输入）	可自定义（4~30 或 -1）

说明：
- 当任务类型强制 ratio=adaptive 时，输出比例自动跟随输入素材，此时传入的 ratio 不生效。
- 当任务类型强制 duration=-1 时，输出时长由系统根据输入视频自动决定，此时传入的 duration 不生效，且该场景仅支持按 token 计费。
- edit / extend 缺少参考视频时，请求会被拒绝（参数错误）。

错误码

code	说明
0	成功
10002	参数缺失或格式错误
10005	API Key 无效或缺失
10006	余额不足
30003	任务不存在
90003	服务器内部错误

最佳实践

1. 轮询策略

建议的轮询间隔：
- 前 30 秒：每 3 秒查询一次
- 30 秒 ~ 2 分钟：每 5 秒查询一次
- 2 分钟后：每 10 秒查询一次

2. 处理时间参考

纯文本生视频：通常 1 ~ 3 分钟
图片+文本生视频：通常 1 ~ 3 分钟
多模态输入（含视频/音频）：通常 2 ~ 4 分钟
时长越长，处理时间越长

3. Prompt 建议

提示词长度：3 ~ 20,000 字符
提示词 = 主体 + 运动，背景 + 运动，镜头 + 运动
用简洁准确的自然语言写出想要的效果
可以指定镜头运动（推进、拉远、环绕等）
通过 "图片1"、"图片2"、"视频1"、"音频1" 引用 content 中对应位置的参考素材
当生成结果不符合预期时，建议修改提示词，将抽象描述换成具象描述
如果有明确的效果预期，建议先用生图模型生成符合预期的图片，再用图生视频

常见问题

Q1: Seedance 2.5 Oversea 相比上一代有什么提升？

A: Seedance 2.5 为新一代旗舰模型，在画面细节、动态表现、镜头稳定性以及多模态素材理解上均有明显提升，更适合追求高质量画面的场景。

Q2: generateAudio 和 realPersonMode 默认是什么？

A: 两者均默认为 true。generateAudio 会在生成视频时一并生成音频；realPersonMode 会开启真人模式优化。如需关闭，显式传 false 即可。

Q3: content 中可以不传 text 吗？

A: 不可以。content 数组中必须包含至少一个 text 类型的内容项作为提示词，否则请求会被拒绝。

技术支持

如有疑问，请联系我们的技术支持团队。