火山引擎 Seedance API

本页示例针对本站 NewAPI 的 DoubaoVideo 适配器。产品官方名称为 Seedance；示例使用本站别名 seedance-2.0。调用前请先通过 /v1/models 确认模型对你的令牌可见。

当前服务提供的模型

截至 2026-09-20，本站已启用以下 Seedance 模型别名：

模型 ID	说明
`seedance-2.0`	标准视频模型
`seedance-2.0-fast`	快速视频模型
`seedance-2.0-min`	站点配置的视频模型别名
`seedance-2.5`	站点配置的视频模型别名

这些名称是客户端应提交的本站模型 ID。具体上游版本、参数范围、价格和权限由站点渠道配置决定；不要根据别名推断未在文档中明确承诺的能力。完整站点能力见可用模型。

查询当前账号可用模型

bash

curl -sS "https://newapi.fq-hx.com/v1/models" \
  -H "Authorization: Bearer $NEWAPI_API_KEY"

不要根据本文列表硬编码未经查询的模型名。管理员升级公共镜像、调整渠道或权限后，实际返回列表可能变化。

已验证的最小参数组合

以下组合已用于本站接入验证：

参数	示例值
模型	`seedance-2.0`
时长	`5` 秒
分辨率	`720p`
比例	`16:9`
音频	关闭

参数位置很重要

在本站当前适配器中，Seedance 专用的 duration、resolution、ratio、generate_audio 等参数应放入 metadata。不要只在请求顶层填写通用 duration，否则它可能不会按预期传给上游。

文生视频

bash

curl -sS "https://newapi.fq-hx.com/v1/video/generations" \
  -H "Authorization: Bearer $NEWAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "电影感远景，一只机械蝴蝶飞过雨后的未来城市，湿润路面反射霓虹灯，镜头缓慢向前推进",
    "metadata": {
      "duration": 5,
      "resolution": "720p",
      "ratio": "16:9",
      "camera_fixed": false,
      "generate_audio": false,
      "watermark": false
    }
  }'

单图生视频

image 可以是上游可访问的 HTTPS 图片地址。请勿使用局域网地址、需要登录的地址或很快过期的临时链接。

bash

curl -sS "https://newapi.fq-hx.com/v1/video/generations" \
  -H "Authorization: Bearer $NEWAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "保持主体外观一致，人物自然转头并微笑，衣物与头发有轻微风动，镜头固定，动作平稳",
    "image": "https://example.com/reference.png",
    "metadata": {
      "duration": 5,
      "resolution": "720p",
      "ratio": "9:16",
      "camera_fixed": true,
      "generate_audio": false
    }
  }'

多参考图

通用方式可以使用 images：

json

{
  "model": "seedance-2.0",
  "prompt": "以参考图中的同一虚拟角色为主体，保持脸部、发型和服装设计一致",
  "images": [
    "https://example.com/front.png",
    "https://example.com/side.png"
  ],
  "metadata": {
    "duration": 5,
    "resolution": "720p",
    "ratio": "9:16",
    "camera_fixed": true,
    "generate_audio": false
  }
}

当你需要为参考内容指定 role，或使用已经审核的 asset:// 资产时，应直接使用 metadata.content。如果同时提供 image/images 和 metadata.content，以 metadata.content 为准，避免混用。

json

{
  "model": "seedance-2.0",
  "prompt": "以参考资产中的原创虚拟人物作为唯一角色，保持身份、发型和服装一致，镜头固定",
  "metadata": {
    "content": [
      {
        "type": "image_url",
        "image_url": { "url": "asset://asset-xxxx" },
        "role": "reference_image"
      }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "9:16",
    "camera_fixed": true,
    "generate_audio": false
  }
}

asset://asset-xxxx 只是格式示例，不能直接使用。资产必须来自你的上游账号，且已满足该账号所需的授权和审核条件。详见虚拟人与人像素材。

可传递的 Seedance 参数

当前适配器可以从 metadata 传递以下字段：

字段	类型	用途
`content`	array	文本、图片、视频或音频参考内容；文本提示最终由顶层 `prompt` 添加
`duration`	integer	视频时长
`resolution`	string	输出分辨率，例如已验证的 `720p`
`ratio`	string	画面比例，例如 `16:9`、`9:16`
`frames`	integer	帧数；不要与时长参数随意同时设置
`seed`	integer	随机种子
`camera_fixed`	boolean	是否固定镜头
`generate_audio`	boolean	是否生成音频，需模型和账号支持
`watermark`	boolean	是否添加水印
`return_last_frame`	boolean	是否返回尾帧，需上游支持
`service_tier`	string	服务等级，需上游支持
`execution_expires_after`	integer	任务执行有效时间，需上游支持
`draft`	boolean	草稿模式，需上游支持
`tools`	array	上游工具列表，需模型支持
`callback_url`	string	上游回调地址；使用前应完成服务端验签与幂等设计

不同模型、账号权限和发布时间支持的取值可能不同。除本站已验证组合外，请以火山引擎当前官方文档和控制台提示为准。

JavaScript 示例

下面的代码应运行在你自己的服务端，而不是浏览器中：

const response = await fetch('https://newapi.fq-hx.com/v1/video/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.NEWAPI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'seedance-2.0',
    prompt: '清晨海边，一艘白色帆船缓慢驶过，电影感广角镜头',
    metadata: {
      duration: 5,
      resolution: '720p',
      ratio: '16:9',
      generate_audio: false,
    },
  }),
})

if (!response.ok) {
  throw new Error(`${response.status}: ${await response.text()}`)
}

const task = await response.json()
console.log(task.id)

Python 示例

python

import os
import requests

response = requests.post(
    "https://newapi.fq-hx.com/v1/video/generations",
    headers={
        "Authorization": f"Bearer {os.environ['NEWAPI_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "seedance-2.0",
        "prompt": "清晨海边，一艘白色帆船缓慢驶过，电影感广角镜头",
        "metadata": {
            "duration": 5,
            "resolution": "720p",
            "ratio": "16:9",
            "generate_audio": False,
        },
    },
    timeout=60,
)
response.raise_for_status()
print(response.json()["id"])

提交后的处理

保存返回的 task_...，然后按照视频任务 API查询：

bash

curl -sS "https://newapi.fq-hx.com/v1/videos/task_xxxxxxxxxxxx" \
  -H "Authorization: Bearer $NEWAPI_API_KEY"

不要因为请求耗时而重复提交同一个任务；重复提交会创建多个任务，并可能分别计费。

火山引擎 Seedance API ​

当前服务提供的模型 ​

查询当前账号可用模型 ​

已验证的最小参数组合 ​

文生视频 ​

单图生视频 ​

多参考图 ​

可传递的 Seedance 参数 ​

JavaScript 示例 ​

Python 示例 ​

提交后的处理 ​

火山引擎 Seedance API

当前服务提供的模型

查询当前账号可用模型

已验证的最小参数组合

文生视频

单图生视频

多参考图

可传递的 Seedance 参数

JavaScript 示例

Python 示例

提交后的处理