Seedance 2.0 Fast

模型名称：seedance-2.0-fast

面向更快出样的视频生成与编辑场景
提交成功后返回视频任务 ID
当前不同分组会命中不同规格实现
default 组 duration 当前支持 5 到 15 秒
对外优先使用统一公共字段 size + resolution
default 组不支持参考音频
standard 组同样使用统一公共字段提交

请求鉴权

所有接口均需要使用 Bearer Token 进行认证。

Authorization: Bearer YOUR_API_KEY

提交任务接口

POST /v1/videos

请求参数

字段	类型	必填	默认值	说明
`model`	`string`	是	-	固定传 `seedance-2.0-fast`
`prompt`	`string`	是	-	视频生成提示词
`n`	`number`	否	`1`	当前仅支持传 `1`
`images`	`string[]`	否	-	参考图地址数组；不同分组支持范围不同
`video_urls`	`string[]`	否	-	参考视频地址数组；不同分组支持范围不同
`audio_urls`	`string[]`	否	-	参考音频地址数组；仅部分分组可用
`duration`	`number`	否	`5`	视频时长；不同分组校验范围不同
`size`	`string`	否	`16:9`	对外统一比例字段，推荐传 `16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`21:9`
`resolution`	`string`	否	`720p`	清晰度档位；`default` 当前主公开档位为 `480p / 720p`
`reference_mode`	`string`	否	-	参考模式，可传 `full_reference` 或 `frame_pair`
`return_last_frame`	`boolean`	否	-	是否返回最后一帧
`generate_audio`	`boolean`	否	-	是否生成音频
`watermark`	`boolean`	否	-	是否添加水印
`callback_url`	`string`	否	-	任务完成后的业务回调地址

分组参数说明

以下只列不同分组之间存在差异的字段：

差异项	`standard` 组	`default` 组
`images`	`0-9` 张	`0-4` 张
`video_urls`	`0-3` 条	`0-3` 条；与图片合计不超过 `7` 份素材
`audio_urls`	`0-3` 条	当前不支持
`duration`	支持 `4-15` 秒	支持 `5-15` 秒
`size`	支持 `16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / adaptive`	支持 `16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9`
`resolution`	支持 `480p / 720p`	支持 `480p / 720p`
`reference_mode`	支持 `full_reference`、`frame_pair`	支持 `full_reference`、`frame_pair`

响应

提交成功响应示例：

{
  "id": "video_task_01KQEXAMPLE_SEEDANCE20_FAST",
  "object": "video",
  "model": "seedance-2.0-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1711111111
}

提交失败响应示例：

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "参数错误，请检查 prompt、images、video_urls、audio_urls、duration、size、resolution 或 reference_mode 是否符合当前模型要求"
  }
}

任务查询接口

GET /v1/videos/{task_id}

查询成功示例：

{
  "id": "video_task_01KQEXAMPLE_SEEDANCE20_FAST",
  "object": "video",
  "model": "seedance-2.0-fast",
  "status": "completed",
  "progress": 100,
  "result_url": "https://example.com/result/seedance-20-fast.mp4"
}

使用示例

基础生成

curl --request POST \
  --url https://api.aimaxa.cn/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.0-fast",
    "prompt": "生成一段运动感更强的夜景街头镜头，节奏快，转场利落",
    "n": 1,
    "duration": 5,
    "size": "16:9",
    "resolution": "720p",
    "return_last_frame": true
  }'

首尾帧参考视频

curl --request POST \
  --url https://api.aimaxa.cn/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.0-fast",
    "prompt": "让首帧中的人物快速冲向尾帧的终点位置，镜头有明显速度感",
    "n": 1,
    "images": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "duration": 5,
    "size": "9:16",
    "resolution": "720p",
    "reference_mode": "frame_pair"
  }'

注意事项

default 与 standard 的素材数量和严格校验边界不同，请按当前分组口径传参。
default 当前不支持参考音频；若你需要 audio_urls，请按本页 standard 组参数范围调用。
对外统一优先使用 size + resolution 这组公共字段。
reference_mode=frame_pair 时必须传 1-2 张图片，且不能同时传 video_urls 或 audio_urls。
standard 组的 audio_urls 需要与 images 或 video_urls 一起使用。
提交成功后请使用 GET /v1/videos/{task_id} 继续轮询结果。

异步状态与失败响应

视频任务状态只使用 queued、in_progress、completed、failed。处于 queued 或 in_progress 时继续调用查询接口；只有 completed 状态才读取顶层 result_url。任务失败时保持视频对象结构，并返回顶层 error 与 fail_reason，不要按图片接口读取 code/data/works：

{
  "id": "video_task_01KQEXAMPLE_FAILED",
  "object": "video",
  "model": "seedance-2.0-fast",
  "status": "failed",
  "progress": 100,
  "error": {
    "code": "task_failed",
    "message": "请求处理失败，请稍后重试"
  },
  "fail_reason": "请求处理失败，请稍后重试"
}

开始使用

图像模型

视频模型

文本模型

Seedance 2.0 Fast

请求鉴权

提交任务接口

请求参数

分组参数说明

响应

任务查询接口

使用示例

基础生成

首尾帧参考视频

注意事项

异步状态与失败响应

​请求鉴权

​提交任务接口

​请求参数

​分组参数说明

​响应

​任务查询接口

​使用示例

​基础生成

​首尾帧参考视频

​注意事项

​异步状态与失败响应

请求鉴权

提交任务接口

请求参数

分组参数说明

响应

任务查询接口

使用示例

基础生成

首尾帧参考视频

注意事项

异步状态与失败响应