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

​
申请流程

要使用 API，需要先到 SeeDance Videos Generation API 对应页面申请对应的服务，进入页面之后，点击「Acquire」按钮，如图所示： 如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。 在首次申请时会有免费额度赠送，可以免费使用该 API。

​
基本使用

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

可以看到这里我们设置了 Request Headers，包括：
  • accept：想要接收怎样格式的响应结果，这里填写为 application/json，即 JSON 格式。
  • authorization：调用 API 的密钥，申请之后可以直接下拉选择。
另外设置了 Request Body，包括：
  • model：生成视频的模型，可选值：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。
  • content：输入内容数组，type 可以是 text 或 image_url。
  • resolution：输出分辨率，可选 480p / 720p / 1080p。
  • ratio：宽高比，可选 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive。
  • duration：视频时长（秒），范围 2–12。
  • seed：随机种子，整数，-1 到 4294967295。
  • camerafixed：是否固定摄像头，true / false。
  • watermark：是否添加水印，true / false。
  • generate_audio：是否生成有声视频，true / false，仅 doubao-seedance-1-5-pro-251215 支持。
  • service_tier：推理模式，default（在线）或 flex（离线，价格为在线的 50%）。
  • return_last_frame：是否在结果中返回视频最后一帧图片 URL。
  • execution_expires_after：任务超时时间（秒），范围 3600–259200。
  • callback_url：异步回调地址，设置后 API 立即返回 task_id，任务完成时将结果 POST 到该地址。
选择之后，可以发现右侧也生成了对应代码，如图所示：

点击「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 等），为强校验模式，参数填写有误时会返回明确错误提示，更易于排查问题。

​
生成有声视频

doubao-seedance-1-5-pro-251215 支持通过 generate_audio 参数生成带音频的视频：
其他模型不支持此参数，传入后会被忽略。

​
图生视频首帧

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

​
图生视频首尾帧

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

​
异步回调

由于 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 可通过输入提示词以及参考图片来生成视频。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。