外观
火山引擎 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 构造上游请求;具体字段和取值仍受模型及上游限制:
| 字段 | 类型 | 用途 |
|---|---|---|
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 示例
下面的代码应运行在你自己的服务端,而不是浏览器中:
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"不要因为请求耗时而重复提交同一个任务;重复提交会创建多个任务,并可能分别计费。