Seedance 2.5 API 接口文档

1、文生视频

curl -X POST https://tokenra.io/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "artsdance-2-5-pro-260801",
    "content": [
      {
        "type": "text",
        "text": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "watermark": false
  }'

2、多模态参考

curl -X POST https://tokenra.io/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "artsdance-2-5-pro-260801",
    "content": [
      {
        "type": "text",
        "text": "明亮多彩的广告片风格，果味饼干为主角，包含草莓、苹果、葡萄、橙子四种口味，草莓味参考@图像1.."
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seedance2.5_reference1.png" },
        "role": "reference_image"
      },
      {
        "type": "video_url",
        "video_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference2.mp4" },
        "role": "reference_video"
      },
      {
        "type": "video_url",
        "video_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference3.mp4" },
        "role": "reference_video"
      },
      {
        "type": "video_url",
        "video_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference4.mp4" },
        "role": "reference_video"
      },
      {
        "type": "video_url",
        "video_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference5.mp4" },
        "role": "reference_video"
      },
      {
        "type": "video_url",
        "video_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference6.mp4" },
        "role": "reference_video"
      },
      {
        "type": "video_url",
        "video_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference7.mp4" },
        "role": "reference_video"
      }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 15
  }'

3、有声视频-首帧

curl -X POST https://tokenra.io/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "artsdance-2-5-pro-260801",
    "content": [
      {
        "type": "text",
        "text": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动，可以听到风声"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png" }
      }
    ],
    "generate_audio": true,
    "ratio": "adaptive",
    "duration": 5,
    "watermark": false
  }'

4、有声视频-首尾帧

curl -X POST https://tokenra.io/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "artsdance-2-5-pro-260801",
    "content": [
      {
        "type": "text",
        "text": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动，可以听到风声"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png" }
      }
    ],
    "generate_audio": true,
    "ratio": "adaptive",
    "duration": 5,
    "watermark": false
  }'

model · string · 必选

模型 ID，填入 artsdance-2-5-pro-260801。

content · object[] · 必选

输入内容列表，支持纯文本，以及文本（可选）与图片、视频、音频的任意组合；Seedance 2.5 支持单独传入音频。

文本信息

提示词说明：

• 语言支持：中文、英文、西班牙语、印度尼西亚语、葡萄牙语、日语、马来语、泰语、阿拉伯语、越南语、韩语
• 字数建议：中文不超过 500 字，英文不超过 1000 词

图片信息

role 取值说明：

单张图片要求：

• 格式：jpeg、png、webp、bmp、tiff、gif、heic、heif
• 宽高比（宽/高）：[0.4, 2.5]
• 宽高长度（px）：[300, 6000]
• 大小：单张 < 30 MB，请求体 ≤ 64 MB

视频信息

单个视频要求：

• 格式：mp4、mov（支持 H.264/AVC、H.265/HEVC 编码）
• 分辨率：480p、720p、1080p、4k
• 时长：非视频编辑任务 [2, 30] s；视频编辑任务 [4, 30] s；最多 10 个，所有视频总时长 ≤ 30 s
• 宽高比：[0.4, 2.5]；宽高长度 [300, 6000] px
• 大小：单个 ≤ 200 MB；帧率 [24, 60] FPS

音频信息

单个音频要求：

• 格式：wav、mp3
• 时长：单个 [2, 30] s，最多 10 段，总时长 ≤ 30 s
• 大小：单个 ≤ 15 MB，请求体 ≤ 64 MB

omni_reference_task_type · string · 默认值 auto

Seedance 2.5 全模态参考生视频任务类型引导。

resolution · string

默认 720p，可选 720p、1080p。1080p 视频采用 10bit 位深 + H.265/HEVC 编码，满足专业影视制作需求。

ratio · string

默认值：adaptive

duration · integer

生成视频时长（秒）。默认值 -1（智能选择），取值范围 [4, 30] 或 -1。

generate_audio · boolean · 默认值 true

• true：生成包含同步音频的有声视频（人声 + 音效 + 背景音乐）
• false：生成无声视频

output_format · string · 默认值 mp4

mov 格式兼容播放器：

watermark · boolean · 默认值 false

• true：生成视频右下角展示“AI 生成”水印
• false：不含水印

return_last_frame · boolean · 默认值 false

是否返回生成视频的尾帧图像（png 格式，无水印）。可用上一个视频尾帧作为下一个任务首帧，生成多个连续视频。

callback_url · string

任务结果回调通知地址。状态变化时向此地址推送 POST 请求。状态包括 queued、running、succeeded、failed、expired。

execution_expires_after · integer · 默认值 172800

任务超时阈值（秒），从 created_at 开始计算，默认 48 小时，取值范围 [3600, 259200]。

priority · integer · 默认值 0

执行优先级，数值越大优先级越高，取值范围 [0, 9]。相同优先级按 FIFO；仅影响同一 Endpoint 内排队顺序，不中断已运行任务。

tools · object[]

工具配置，支持 type: web_search（联网搜索）。开启后模型自主判断是否搜索互联网内容，可提升时效性但会增加时延。

safety_identifier · string

终端用户唯一标识符（英文字符串，长度 ≤ 64），建议传入对用户名、ID 或邮箱哈希处理后的字符串。

id · string

视频生成任务 ID，仅保存 7 天（从 created_at 时间戳开始计算）。创建任务为异步接口，获取 ID 后需通过查询 API 查询状态，成功后从 video_url 获取视频。

任务基本信息

status 取值说明：

输出内容 content

视频参数信息

其他参数

工具使用 tools

Token 用量 usage

错误信息 error

任务成功时返回 null，任务失败时返回错误数据。