Skip to main content
本文将介绍一种 SeeDance Videos Generation API 对接说明，它是可以通过输入自定义参数来生成SeeDance官方的视频。

​
申请流程

要使用 SeeDance Videos Generation API，首先到 Ace Data Cloud 控制台 获取您的 API Token，留作备用。 如果你尚未登录或注册，会自动跳转到登录页面邀请你注册和登录，完成后会自动返回当前页面。 一个 API Token 即可调用平台所有服务，无需为每个服务单独申请。 首次申请会赠送免费额度，可免费体验；额度不足时可在 控制台 充值通用余额。
📘 完整文档：SeeDance Videos Generation API →

​
基本使用

首先先了解下基本的使用方式，就是输入提示词 content.text、类型content.type=text 以及模型 model，便可获得处理后的结果，具体的内容如下：

可以看到这里我们设置了 Request Headers，包括：
  • accept：想要接收怎样格式的响应结果，这里填写为 application/json，即 JSON 格式。
  • authorization：调用 API 的密钥，申请之后可以直接下拉选择。
另外设置了 Request Body，包括：
  • model：生成视频的模型。
    • Seedance 1.x 系列：doubao-seedance-1-0-pro-250528、doubao-seedance-1-0-pro-fast-251015、doubao-seedance-1-5-pro-251215、doubao-seedance-1-0-lite-t2v-250428、doubao-seedance-1-0-lite-i2v-250428。
    • Seedance 2.0 系列（支持角色和音视频多模态参考）：doubao-seedance-2-0-260128（标准）、doubao-seedance-2-0-fast-260128（快速）、doubao-seedance-2-0-mini-260615（轻量）。
    • Seedance 2.5：doubao-seedance-2-5-260628，支持最长 30 秒、纯音频参考、更多素材、视频编辑与延长。
  • content：输入内容数组，type 可以是 text（提示词）、image_url（参考图片）、audio_url（参考音频）、video_url（参考视频）。图片可通过 role 指定用途：first_frame（首帧）/ last_frame（尾帧）/ reference_image（角色 / 主体参考）。
  • resolution：输出分辨率，可选 480p / 720p / 1080p / 4k。2.5 支持 480p、720p、1080p；2.0 Fast/Mini 支持 480p、720p；2.0 Standard 最高支持 4k。
  • ratio：宽高比，可选 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive。
  • duration：视频时长（秒，整数）。1.0 系列 2–12；1.5 Pro 4–12；2.0 系列 4–15；2.5 为 4–30。1.5/2.x 支持 -1（自动时长）。
  • seed：随机种子，整数，-1 到 4294967295。
  • camerafixed：是否固定摄像头，true / false。
  • watermark：是否添加水印，true / false。
  • generate_audio：是否生成有声视频，true / false，Seedance 1.5 Pro 与 2.x 系列支持。
  • return_last_frame：是否在结果中返回视频最后一帧图片 URL。
  • omni_reference_task_type：仅 2.5；auto / reference / edit / extend。
  • output_format：仅 2.5；mp4 / mov，默认 mp4。
  • tools：仅 2.5；当前支持 web_search 联网检索工具，可限制结果数、关键词数和搜索来源。
  • priority：2.5 可选任务优先级，整数 0–9，默认 0。
  • safety_identifier：最长 64 字符的稳定匿名终端用户标识；请使用哈希或内部匿名 ID，不要传入姓名、邮箱或手机号。
  • execution_expires_after：任务超时时间（秒），范围 3600–259200。
  • callback_url：异步回调地址，设置后 API 立即返回 task_id，任务完成时将结果 POST 到该地址。
  • async：可选，设为 true 时接口立即返回 task_id，无需提供 callback_url，随后通过对应的任务查询接口轮询获取结果。
选择之后，可以发现右侧也生成了对应代码，如图所示：

点击「Try」按钮即可进行测试，如上图所示，这里我们就得到了如下结果：
返回结果一共有多个字段，介绍如下：
  • success，此时视频生成任务的状态情况。
  • task_id，此时视频生成任务ID。
  • trace_id，此时视频生成跟踪ID。
  • data，此时视频生成任务的结果列表。
    • task_id，此时视频生成任务的服务器端ID。
    • video_url，此时视频生成任务的视频链接。
    • status，此时视频生成任务的状态。
      • model，生成视频使用的模型。
可以看到我们得到了满意的视频信息，我们只需要根据结果中 data 的视频链接地址获取生成的SeeDance视频即可。 另外如果想生成对应的对接代码，可以直接复制生成，例如 CURL 的代码如下：

​
内联参数说明

在 content[].text 提示词末尾，可以通过追加 --parameter value 的形式传入生成参数（旧方式，弱校验，填写有误时自动使用默认值）。完整参数列表如下：
推荐做法：直接在 Request Body 中使用对应的顶层字段（如 resolution、ratio 等），为强校验模式，参数填写有误时会返回明确错误提示，更易于排查问题。

​
生成有声视频

Seedance 1.5 Pro 与 2.x 系列支持通过 generate_audio 参数生成带音频的视频：
1.0 系列不支持此参数。

​
Seedance 2.5 全模态生成、编辑与延长

doubao-seedance-2-5-260628 支持 480p / 720p / 1080p、4–30 秒或自动时长，并把素材上限提高到 30 张参考图、10 段参考视频、10 段参考音频（总计最多 50 个）。2.5 还支持仅传参考音频，不再要求同时提供图片或视频。 普通全模态生成可省略 omni_reference_task_type，设为 auto，或显式设为 reference。视频编辑与延长必须传入 reference_video：
  • reference：至少传入一个 reference_image、reference_video 或 reference_audio；2.5 支持仅传参考音频。
  • edit：必须使用 ratio: adaptive 和 duration: -1；输出时长按实际结果计费。
  • extend：必须使用 ratio: adaptive；duration 可为 4–30 或 -1。
  • auto：模型根据提示词和素材自动选择生成、编辑或延长。
  • 任务类型与素材或提示词不匹配时，任务会失败并返回可定位的参数错误；请按上述约束调整后重新提交。

​
图生视频首帧

如果想图生视频任务，首先 content 参数需要包含 type 为 image_url 的项，image_url 字段必须为对象格式：{"url": "https://..."} 或 Base64 格式 {"url": "data:image/png;base64,..."}。
注意：image_url 不支持直接传入字符串格式（如 "image_url": "https://cdn.acedata.cloud/e724d7f13d.png"），必须使用对象格式 "image_url": {"url": "https://..."}，否则会返回 400 错误。
对应的代码：
点击运行，可以发现会立即得到一个结果，如下：
可以看到，生成的效果是图生建视频的，结果与上文类似。

​
图生视频首尾帧

如果想图生视频首尾帧， 首先参数content必须传入类型image_url,并且分别设置role为first_frame和last_frame，就可以指定如下内容：
  • role：指定首帧或者尾帧。
  • image_url
    • url 图片链接 同时 content 还需要输入类型text作为prompt提示词
对应的代码：
点击运行，可以发现会立即得到一个结果，如下：
可以看到，生成的效果是角色生成视频，结果与上文类似。

​
角色与音视频多模态参考（Seedance 2.0）

Seedance 2.0 系列（doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615）支持 reference_image、reference_audio 与 reference_video。可使用自有或已获授权的素材保持角色、主体、动作、运镜、声音与节奏的一致性。
请仅上传自有或已获授权的真人与角色素材。不同模型对真人素材的支持方式不同；请求格式保持不变，若素材不符合要求会返回明确错误。
使用要点：
  • 仅 Seedance 2.0 系列模型支持 reference_image；1.x 模型请使用 first_frame / last_frame（图生视频首尾帧）。
  • 图生视频首帧、图生视频首尾帧和全模态参考是三种互斥场景：first_frame / last_frame 不能与 reference_image / reference_video / reference_audio 混用。
  • 若想在全模态参考中指定首尾帧，请把图片标为 reference_image，并在提示词中写明“图片 1 作为首帧”或“图片 2 作为尾帧”；若需要严格锁定首尾帧，则只使用 first_frame / last_frame。
  • 多模态参考数量上限：image_url 最多 9 张；2.0 还支持 audio_url（role 为 reference_audio，最多 3 条）与 video_url（role 为 reference_video，最多 3 条）。
  • 参考音频（audio_url）素材要求：格式 wav / mp3；单条时长 2~15 秒，最多 3 条且总时长不超过 15 秒；单条不超过 15 MB。超出时长范围会在素材处理阶段失败。
  • 参考视频（video_url）素材要求：格式 mp4 / mov；单条时长 2~15 秒，最多 3 条且总时长不超过 15 秒。
  • 参考图片建议使用单人、正脸、清晰、无遮挡的照片，人脸越清晰，相似度越高。

​
示例一：保持人物样貌的特写

传入一张人脸照片，让该人物对着镜头微笑挥手。对应的代码：
返回结果如下，生成的视频中人物与参考照片保持一致：

​
示例二：把同一个人放进全新场景

reference_image 的强大之处在于：只保留人物身份，而场景、服装、动作完全由提示词决定。下面用同一张人脸照片，让该人物身着米色大衣走在秋日公园里：
返回结果如下，人物样貌得以保留，而场景已切换为秋日公园：
💡 若想让人物精确复刻照片中的构图（而非「换个场景的同一个人」），可改用 first_frame（图生视频首帧），让视频从这张照片开始运动。

​
异步回调

由于 SeeDance Videos Generation API 生成时间较长（约 1-2 分钟），可通过 callback_url 字段使用异步模式，避免 HTTP 连接长时间占用。 整体流程：客户端发起请求时指定 callback_url，API 立即返回包含 task_id 的响应；任务完成后，平台将生成结果以 POST JSON 的形式发送到 callback_url，结果中同样包含 task_id 以便关联。
任务完成时，平台推送到 callback_url 的内容如下：
结果中的 task_id 字段与请求时返回的一致，通过该字段即可实现任务的关联。

​
错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：
  • 400 token_mismatched：Bad request, possibly due to missing or invalid parameters.
  • 400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.
  • 401 invalid_token：Unauthorized, invalid or missing authorization token.
  • 429 too_many_requests：Too many requests, you have exceeded the rate limit.
  • 500 api_error：Internal server error, something went wrong on the server.

​
错误响应示例

​
结论

通过本文档，您已经了解了如何使用 Seedance Videos Generation API 进行文生视频、首尾帧与多模态参考生成，以及使用 Seedance 2.5 编辑或延长视频。希望本文档能帮助您完成 API 对接；如有问题，请联系技术支持。