Skip to content

火山引擎 Seedance API ​

本文中的 Bash/curl 命令用于 macOS/Linux;Windows PowerShell 的变量说明见认证与安全,JSON 请求写法见文本 API。

本页示例针对本站 FQHX 的 DoubaoVideo 渠道和当前 doubao 任务插件。产品官方名称为 Seedance;示例使用本站别名 seedance-2.0。调用前请先通过 /v1/models 确认模型对你的令牌可见。

协议示例中的模型 ​

配置核对时间见模型目录;渠道中配置以下 Seedance 模型别名:

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

协议参考

本页保留 Seedance 参数及素材格式参考;当前对外模型目录不列视频模型,不展示内部渠道分组。

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

查询当前账号可用模型 ​

使用首页 HTTP 验证模块中的“模型列表”标签查询当前令牌的实际权限。

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

历史验证与当前示例 ​

2026-09-20 的历史记录中存在 seedance-2.0 成功任务;这不能证明升级到当前服务版本后已重新完成生成验证。本轮只核对了配置、插件接口和文档,未发起计费请求。下方保留短视频参数作为验证起点:

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

参数位置很重要

在本站当前适配器中,Seedance 专用的 duration、resolution、ratio、generate_audio 等参数应放入 metadata。时长也可使用顶层 seconds,它会覆盖 metadata.duration;不要同时传入相互冲突的时长。resolution、ratio 和素材内容统一放入 metadata。

文生视频 ​

bash
curl --fail-with-body -sS "https://newapi.fq-hx.com/v1/videos" \
  -H "Authorization: Bearer $FQHX_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
    }
  }'

单图生视频 ​

参考图通过 metadata.content 中的 image_url 提供,地址应是上游可访问的 HTTPS URL。请勿使用局域网地址、需要登录的地址或很快过期的临时链接。

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

多参考图 ​

参考图统一写入 metadata.content,需要时指定 role。两个参考图的格式如下:

json
{
  "model": "seedance-2.0",
  "prompt": "保持参考角色的外观一致",
  "metadata": {
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/front.png"}, "role": "reference_image"},
      {"type": "image_url", "image_url": {"url": "https://example.com/side.png"}, "role": "reference_image"}
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "9:16",
    "generate_audio": false
  }
}

当前插件会合并 images 和 metadata.content 中的参考内容,而不是用后者覆盖前者。示例统一使用 metadata.content,避免重复引用。不要假设旧入口的顶层 image 归一化在每条新版路由中都存在。已审核的火山引擎资产可以按下面格式引用:

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 构造上游请求;具体字段和取值仍受模型及上游限制:

字段类型用途
contentarray文本、图片、视频或音频参考内容;文本提示最终由顶层 prompt 添加
durationinteger视频时长
resolutionstring输出分辨率,例如历史成功任务使用的 720p
ratiostring画面比例,例如 16:9、9:16
framesinteger帧数;不要与时长参数随意同时设置
seedinteger随机种子
camera_fixedboolean是否固定镜头
generate_audioboolean是否生成音频,需模型和账号支持
watermarkboolean是否添加水印
return_last_frameboolean是否返回尾帧,需上游支持
service_tierstring服务等级,需上游支持
execution_expires_afterinteger任务执行有效时间,需上游支持
draftboolean草稿模式,需上游支持
toolsarray上游工具列表,需模型支持
callback_urlstring上游回调地址;使用前应完成服务端验签与幂等设计

不同模型、账号权限和发布时间支持的取值可能不同。所有组合均需按当前服务版本验证,请以火山引擎当前官方文档和控制台提示为准。

JavaScript 示例 ​

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

js
const response = await fetch('https://newapi.fq-hx.com/v1/videos', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.FQHX_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(`Video submission failed: HTTP ${response.status}`)
}

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

Python 示例 ​

python
import os
import requests

response = requests.post(
    "https://newapi.fq-hx.com/v1/videos",
    headers={
        "Authorization": f"Bearer {os.environ['FQHX_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 --fail-with-body -sS "https://newapi.fq-hx.com/v1/videos/task_xxxxxxxxxxxx" \
  -H "Authorization: Bearer $FQHX_API_KEY"

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

本站提供 FQHX 接入说明;模型能力与审核规则以上游平台最新规定为准。