SeeDance 视频生成 API 集成指南

在本篇文章中，我们将介绍如何集成 SeeDance 视频生成 API。通过此 API，您可以输入自定义参数生成官方的 SeeDance 视频。

简介

SeeDance 视频生成 API 是 Ace Data Cloud 提供的一项服务，该服务能够根据用户提供的文本或图像生成视频内容。它适用于创作者、营销人员和开发者，能够帮助他们快速制作高质量的视频内容，应用场景包括社交媒体视频、营销推广视频等。

环境准备/前置条件

在使用此 API 之前，请确保您具备以下条件： - 注册并登录到 Ace Data Cloud。 - 申请 SeeDance 视频生成 API 服务。

详细步骤

1. 申请 API 服务

访问 SeeDance 视频生成 API 页面，点击"获取"按钮，如下图所示：

如果您未登录，则会自动跳转到登录页面进行注册和登录。首次申请用户可获得免费配额，允许您免费使用 API。

2. 基本用法

了解基本用法后，您可以输入 content.text、类型 content.type=text 和模型 model 来获取处理结果。具体内容如下：

请求头部设置：

accept: 响应结果格式，填写为 application/json，表示返回 JSON 格式。
authorization: 调用 API 的密钥。

请求体设置：

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: 输入内容数组，类型可以是 text 或 image_url。
resolution: 输出分辨率，选项 480p / 720p / 1080p。
ratio: 画面比例，选项包括 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive。
其他参数如 duration、seed、watermark 等。

测试时点击"尝试"按钮，您将获得如下结果：

json 复制代码

{
  "success": true,
  "task_id": "ec22ae22-0140-4033-8c86-a48b536da595",
  "trace_id": "1cc87db0-8ee5-4436-969b-35cc571a9fd5",
  "data": {
    "task_id": "cgt-20251222005129-62fhb",
    "status": "succeeded",
    "video_url": "https://platform.cdn.acedata.cloud/seedance/f592800a-b87c-4705-8796-cbb8018cae35.mp4",
    "model": "doubao-seedance-1-0-pro-250528"
  }
}

3. 内联参数说明

在 content[].text 提示的末尾，您可以以 --parameter value 的形式传递生成参数。完整参数列表如下：

内联参数	对应字段	描述	值范围
`--rs`	`resolution`	输出分辨率	`480p` / `720p` / `1080p`
`--rt`	`ratio`	画面比例	`16:9` / `4:3` / `1:1` / `3:4` / `9:16` / `21:9` / `adaptive`
`--dur`	`duration`	视频时长（秒）	2--12
`--fps`	`framespersecond`	帧率	仅支持 `24`
`--seed`	`seed`	随机种子	-1 到 4294967295
`--wm`	`watermark`	是否添加水印	`true` / `false`

4. 生成带声音的视频

使用 doubao-seedance-1-5-pro-251215 模型支持通过 generate_audio 参数生成带声音的视频：

json 复制代码

{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "A girl holds a fox, the wind blows her hair, you can hear the sound of the wind"
    }
  ],
  "generate_audio": true,
  "ratio": "16:9",
  "duration": 5
}

5. 图像转视频的首帧

要进行图像转视频任务，content 参数必须首先包含一个 type 为 image_url 的项，且 image_url 字段必须使用对象格式。

python 复制代码

import requests

url = "https://api.acedata.cloud/seedance/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "content": [
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
            }
        },
        {
            "type": "text",
            "text": "A girl holds a fox in her arms. --ratio adaptive --dur 5"
        }
    ],
    "model": "doubao-seedance-1-0-pro-250528"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

6. 异步回调

由于生成视频的时间较长（约 1-2 分钟），您可以使用 callback_url 字段进行异步处理，避免长时间占用 HTTP 连接。

常见问题

如何处理 API 错误？
API 会返回相应的错误代码和消息，常见错误包括 400 token_mismatched（请求错误）和 401 invalid_token（未授权）。
如何确认视频生成任务的状态？
使用返回的 task_id，您可以查询当前任务状态。

总结

通过本篇文章，您已经学习了如何使用 SeeDance 视频生成 API，根据输入的提示词和参考图像生成视频。希望本文能帮助您更好地集成和使用此 API。如有任何问题，请随时联系技术支持团队。

技术标签：#视频生成 #API集成 #AceDataCloud #SeeDance #Python