Seedance 2.5

POST/api/v1/jobs/createTask

model 填写 seedance-2.5。国内线路按输入素材选择接口：只有提示词时使用文生视频，支持联网搜索；传入首帧和可选尾帧时使用图生视频，提示词可省略、比例只能为 adaptive；提供参考素材数组时使用多模态接口，可组合最多 30 张图片、10 段视频和 10 段音频，允许提示词搭配单独的音频参考。生成 4 至 30 秒的 480p 或 720p 视频，支持配套音频、视频延长和 MOV 输出。

请求示例

cURL

curl -X POST https://api.xbaiapi.com/api/v1/jobs/createTask \
  -H "Authorization: Bearer xb-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "input": {
      "prompt": "雨夜的城市街口，霓虹灯倒映在湿润的路面上，镜头缓慢向前推进",
      "resolution": "720p",
      "duration": 25,
      "ratio": "16:9",
      "imageUrls": ["https://example.com/street.jpg"],
      "generateAudio": true,
      "outputFormat": "mp4"
    },
    "callBackUrl": "https://your-server.com/webhook"
  }'

移除参考素材数组即可使用文生视频。开启联网搜索时，请将 input 改为：

文生视频 input

{
  "prompt": "中国老城雨夜，红灯笼倒映在湿润路面，镜头缓慢向前推进",
  "resolution": "720p",
  "duration": 25,
  "ratio": "16:9",
  "webSearch": true,
  "generateAudio": true,
  "watermark": false,
  "bitrateMode": "standard",
  "outputFormat": "mp4",
  "draft": false
}

webSearch 仅文生视频支持。realPersonMode 和 conversionSlots 支持图生视频与多模态请求，omniReferenceTaskType 仅多模态支持。首尾帧不能与参考素材数组混用。

首尾帧图生视频可以省略提示词，将 input 改为：

首尾帧 input

{
  "resolution": "720p",
  "duration": 25,
  "firstFrameUrl": "https://example.com/first.jpg",
  "lastFrameUrl": "https://example.com/last.jpg",
  "ratio": "adaptive",
  "realPersonMode": true,
  "conversionSlots": ["firstFrameUrl", "lastFrameUrl"],
  "generateAudio": true,
  "outputFormat": "mov"
}

参数

字段	类型	必填	说明
`model`	string	是	固定值 `seedance-2.5`
`input.prompt`	string	条件必填	最长 20480 字符，首尾帧图生视频允许省略或空字符串，其余模式必填
`input.resolution`	string	否	`480p` 或 `720p`，默认 `720p`
`input.duration`	number	否	4 至 30 的整数秒，默认 5
`input.ratio`	string	否	`adaptive`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16` 或 `21:9`，默认 `adaptive`；首尾帧模式只能为 `adaptive`
`input.firstFrameUrl`	string	条件必填	首帧图片，传入时使用图生视频，单张不超过 30 MB
`input.lastFrameUrl`	string	否	尾帧图片，必须同时提供首帧，单张不超过 30 MB
`input.imageUrls`	string[]	否	最多 30 张参考图片，每张不超过 50 MB
`input.videoUrls`	string[]	否	最多 10 段参考视频，单段 2 至 30 秒、50 MB 以内，总时长不超过 30 秒
`input.audioUrls`	string[]	否	最多 10 段参考音频，单段 2 至 30 秒、50 MB 以内，总时长不超过 30 秒；无需同时提供图片或视频
`input.conversionSlots`	string[]	否	默认 `["all"]`；图生视频可选 `all`、`firstFrameUrl`、`lastFrameUrl`，多模态可选 `all`、`image1` 至 `image30`、`video1` 至 `video10`，文生视频不支持
`input.realPersonMode`	boolean	否	真人模式，图生视频和多模态支持，默认 `true`
`input.webSearch`	boolean	否	联网搜索增强，仅文生视频支持，默认 `false`
`input.returnLastFrame`	boolean	否	请求视频尾帧，默认 `false`；查询结果仍只返回视频
`input.bitrateMode`	string	否	`standard` 或 `high`，默认 `standard`
`input.generateAudio`	boolean	否	是否生成音频，默认 `true`
`input.watermark`	boolean	否	是否添加水印，默认 `false`
`input.seed`	number	否	`-1` 至 `2147483647` 的整数，默认 `-1`
`input.outputFormat`	string	否	`mp4` 或 `mov`，默认 `mp4`
`input.omniReferenceTaskType`	string	否	仅多模态支持。`auto`、`reference` 或 `extend`，默认 `auto`；`extend` 必须提供 `videoUrls` 且 `ratio` 为 `adaptive`
`input.draft`	boolean	否	样片模式，默认 `false`；开启时 `resolution` 必须为 `480p`
`callBackUrl`	string	否	任务完成回调，不填则自行查询

素材支持公开可访问的 HTTP(S) URL 或媒体 Base64 data URI，大小与时长由生成接口校验。Playground 上传图片目前限制为 30 MB，API URL 输入仍按生成接口的 50 MB 限制。

当前不开放 native1080p、1080p、2k、4k、智能时长 -1 以及视频编辑 edit。首尾帧模式使用 firstFrameUrl / lastFrameUrl，多模态参考图片使用 imageUrls。

计费与结果

无参考视频时为 33 credits/秒，有参考视频时为 20 credits/秒，按输出时长预扣；失败自动全额退款。图片、音频、样片和画质档位不改变当前按秒售价。25 秒且无参考视频的示例预扣 825 credits。

创建成功后保存 taskId，通过查询任务或任务回调获取结果。生成视频自动转存，结果保留 30 天。详细规则见计费说明和结果文件。

请求示例

参数

计费与结果

本页目录