视频生成 API

视频生成采用异步任务模式:创建任务 → 轮询状态 → 取结果。视频与 3D 共用同一个任务接口,按 model 字段分流。

当前模型列表和模型广场暂无公开可发现的视频模型调用名。以下视频请求仅用于展示结构,不能直接执行;<MODEL_CALL_NAME> 必须替换为模型广场后续发布的真实调用名。

视频生成走自有接口 + API Key,不是火山 AK/SK 签名。火山兼容接口仅用于素材管理。

关键参数

参数类型必填说明
modelstring模型调用名,必须从模型广场或模型列表获取
contentarray输入内容,支持 textimage_urlvideo_urlaudio_url
resolutionstring模型透传字段;常见值为 480p / 720p / 1080p,以模型详情为准
ratiostring模型透传字段;常见值为 16:9 / 9:16 / 4:3 / 3:4 / 1:1 / 21:9
durationinteger模型透传字段;时长范围以模型详情为准
framesinteger模型透传字段;是否可与 duration 互换以模型详情为准
generate_audioboolean模型透传字段;是否支持配音以模型详情为准
toolsarray模型透传字段;支持的工具以模型详情为准

创建任务认证: Authorization: Bearer <API_KEY>x-api-key: <API_KEY>

查询和取消任务认证: Authorization: Bearer <API_KEY>

https://www.silvamux.com/api/v3 即接入域名下的 /api/v3,对应路由 /api/v3/contents/generations/tasks

创建任务

POST/api/v3/contents/generations/tasks

创建任务

Bearer API Key请求头使用 Authorization: Bearer sk_live_...,也支持 x-api-key。
先确认模型调用名请先在 模型广场 筛选支持当前接口格式的模型,打开模型详情页复制调用名。当前账号的最终可用范围还受组织权限影响。

请求结构

下方内容用于确认方法、地址和鉴权方式,属于 HTTP 结构片段,不是可独立执行示例。

HTTP
POST https://www.silvamux.com/api/v3/contents/generations/tasks
Authorization: Bearer $SILVAMUX_API_KEY
Content-Type: application/json

请求体

application/json · ContentTaskRequest · 必填

字段类型必填说明
callback_urlstring (uri)
contentarray<FreeFormObject>
modelstring

响应

200任务创建成功。

application/json · ContentTask

字段类型说明
contentFreeFormObject
created_atstring (date-time) | integer (int64)API 版本 2026-01-01 返回 RFC3339;2026-06-01 返回 Unix 秒。
errorFreeFormObject
idstring
kindstring (video | 3d)
modelstring
statusContentTaskStatus
updated_atstring (date-time) | integer (int64)API 版本 2026-01-01 返回 RFC3339;2026-06-01 返回 Unix 秒。

defaultVolcengine 兼容错误。

application/json · VolcengineError

字段类型说明
errorFreeFormObject

文生视频

curl -X POST https://www.silvamux.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL_CALL_NAME>",
    "content": [{"type": "text", "text": "一只金毛犬在海滩上奔跑"}],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

图生视频

图生视频分首帧、首尾帧两种场景(互斥)。

首帧

curl -X POST https://www.silvamux.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL_CALL_NAME>",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}, "role": "first_frame"},
      {"type": "text", "text": "镜头缓缓拉远"}
    ]
  }'

首尾帧

curl -X POST https://www.silvamux.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL_CALL_NAME>",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}, "role": "first_frame"},
      {"type": "image_url", "image_url": {"url": "https://example.com/last.jpg"}, "role": "last_frame"},
      {"type": "text", "text": "镜头从白天过渡到夜晚"}
    ]
  }'

多模态参考生视频

参考图片(19)+ 参考视频(03)+ 参考音频(0~3)+ 文本提示词(可选)生成视频,支持全新生成、编辑、延长。

curl -X POST https://www.silvamux.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL_CALL_NAME>",
    "content": [
      {"type": "image_url", "image_url": {"url": "asset://AST-XXXX"}, "role": "reference_image"},
      {"type": "text", "text": "让画面中的角色跳舞"}
    ]
  }'

不可单独输入音频,应至少包含 1 个参考视频或图片。三种图生视频场景(首帧/首尾帧/多模态参考)互斥。

content 字段

文本(text)

字段必选说明
typetext
text提示词,支持中英文。建议中文 ≤500 字,英文 ≤1000 词

图片(image_url)

字段必选说明
typeimage_url
image_url.url图片 URL、Base64 编码(data:image/png;base64,...)或素材 ID(asset://<ASSET_ID>
role条件first_framelast_framereference_image

图片要求:格式 jpeg/png/webp/bmp/tiff/gif;宽高比 (0.4, 2.5);宽高 300–6000px;单张 ≤30MB。

视频(video_url)

字段必选说明
typevideo_url
video_url.url视频 URL 或素材 ID
role条件当前仅支持 reference_video

视频要求:格式 mp4/mov;分辨率 480p/720p/1080p;时长 ≤15s,最多 3 个参考视频,总时长 ≤15s;单个 ≤50MB;帧率 4–60fps。

音频(audio_url)

不可单独输入音频。

字段必选说明
typeaudio_url
audio_url.url音频 URL、Base64 编码或素材 ID
role条件当前仅支持 reference_audio

音频要求:格式 wav/mp3;时长 ≤15s,最多 3 段,总时长 ≤15s;单个 ≤15MB。

响应

创建任务返回任务 ID:

{
  "id": "VTK-01JXXXXXXXXXXXXXX",
  "model": "<MODEL_CALL_NAME>",
  "status": "queued",
  "created_at": "2026-03-31T12:00:00Z"
}

查询任务

GET /api/v3/contents/generations/tasks/:id
GET/api/v3/contents/generations/tasks/{id}

查询任务

Bearer API Key请求头使用 Authorization: Bearer sk_live_...,也支持 x-api-key。

请求结构

下方内容用于确认方法、地址和鉴权方式,属于 HTTP 结构片段,不是可独立执行示例。

HTTP
GET https://www.silvamux.com/api/v3/contents/generations/tasks/{id}
Authorization: Bearer $SILVAMUX_API_KEY

请求参数

参数类型与位置必填说明
idstring · path

响应

200任务详情。

application/json · ContentTask

字段类型说明
contentFreeFormObject
created_atstring (date-time) | integer (int64)API 版本 2026-01-01 返回 RFC3339;2026-06-01 返回 Unix 秒。
errorFreeFormObject
idstring
kindstring (video | 3d)
modelstring
statusContentTaskStatus
updated_atstring (date-time) | integer (int64)API 版本 2026-01-01 返回 RFC3339;2026-06-01 返回 Unix 秒。

defaultOpenAI 兼容错误。

application/json · OpenAIError

字段类型说明
errorobject
error.codestring | integer
error.messagestring
error.typestring
curl https://www.silvamux.com/api/v3/contents/generations/tasks/VTK-01JXXXXXXXXXXXXXX \
  -H "Authorization: Bearer $SILVAMUX_API_KEY"

成功响应:

{
  "id": "VTK-01JXXXXXXXXXXXXXX",
  "status": "succeed",
  "result": {"video_url": "https://..."}
}

任务状态:queued(排队)→ running(生成中)→ succeed / failed / cancelled / expired

任务列表

GET /api/v3/contents/generations/tasks
GET/api/v3/contents/generations/tasks

任务列表

Bearer API Key请求头使用 Authorization: Bearer sk_live_...,也支持 x-api-key。

请求结构

下方内容用于确认方法、地址和鉴权方式,属于 HTTP 结构片段,不是可独立执行示例。

HTTP
GET https://www.silvamux.com/api/v3/contents/generations/tasks
Authorization: Bearer $SILVAMUX_API_KEY

请求参数

参数类型与位置必填说明
page_numinteger · query
page_sizeinteger · query
filter.statusContentTaskStatus · query
filter.modelstring · query
filter.kindstring (video | 3d) · query
filter.task_idsarray<string> · query

响应

200任务列表。

application/json · object

字段类型说明
itemsarray<ContentTask>
items.contentFreeFormObject
items.created_atstring (date-time) | integer (int64)API 版本 2026-01-01 返回 RFC3339;2026-06-01 返回 Unix 秒。
items.errorFreeFormObject
items.idstring
items.kindstring (video | 3d)
items.modelstring
items.statusContentTaskStatus
items.updated_atstring (date-time) | integer (int64)API 版本 2026-01-01 返回 RFC3339;2026-06-01 返回 Unix 秒。
totalinteger (int64)

defaultOpenAI 兼容错误。

application/json · OpenAIError

字段类型说明
errorobject
error.codestring | integer
error.messagestring
error.typestring

取消任务

DELETE /api/v3/contents/generations/tasks/:id
DELETE/api/v3/contents/generations/tasks/{id}

取消任务

Bearer API Key请求头使用 Authorization: Bearer sk_live_...,也支持 x-api-key。

请求结构

下方内容用于确认方法、地址和鉴权方式,属于 HTTP 结构片段,不是可独立执行示例。

HTTP
DELETE https://www.silvamux.com/api/v3/contents/generations/tasks/{id}
Authorization: Bearer $SILVAMUX_API_KEY

请求参数

参数类型与位置必填说明
idstring · path

响应

200任务已取消。

application/json · object

字段类型说明
idstring
statusstring (cancelled)

409OpenAI 兼容错误。

application/json · OpenAIError

字段类型说明
errorobject
error.codestring | integer
error.messagestring
error.typestring

defaultOpenAI 兼容错误。

application/json · OpenAIError

字段类型说明
errorobject
error.codestring | integer
error.messagestring
error.typestring

queued 状态可取消。

生成样例

多模态参考生视频(背景图 + 妆造三视图 + 面部特写图 + 提示词):

提示词:

背景参考图片 1,月白虚影闪过,公子(妆造参考图片 2;人物形象严格参考图片 3)旋身开合折扇,鎏金扇刃弹出,墨竹扇面翻飞,慢鼓重响 1 声;特写:折扇刃格挡反派长刀,扇骨与刀身相击,公子唇角勾轻佻笑意,眼神却冷冽,指腹轻转扇柄。慢镜:公子侧身贴地滑步,折扇刃贴反派腿侧划过,带起一道浅痕,锦袍下摆扫过地面,玉簪轻晃。快切:公子旋身抬手,折扇刃飞射而出,擦过反派脖颈,钉入身后木柱,反派僵立不敢动。反转:身后突然传来掌风,公子旋身接掌,指尖相触时借力后跳,折扇刃从木柱飞回手中,眼神警惕。慢镜高光:公子折扇半开,扇刃抵唇侧,抬眸望向身后,碎发被风吹起,眉梢微扬,带一丝桀骜。拉镜:公子立于庭院石台上,折扇轻摇,镜头拉远,庭院四角同时浮现戴面具的黑影(持弯刀,呈合围之势)。定格:公子折扇合起一半,扇刃露鎏金锋芒,抬步向前,画面压暗,只留他的侧影和扇刃光,音效骤停。音效:折扇开合脆响 + 刃风切割声 + 慢鼓卡点(偏沉稳)。

可用模型

当前可在模型广场发现的 3D 样例模型:doubao-seed3d-2.0。视频模型暂无公开可发现的调用名。

完整模型清单见模型广场。部分模型需要权限标志,由管理员配置。

计费

视频生成按模型与视频参数(分辨率、时长、是否配音)计费,当前单价请在模型广场打开对应模型详情查看。

与火山官方接口的差异

SilvaMux 的 Seedance 接口与火山官方接口字段相似(同款模型),但:

  • 鉴权:用平台 API Key(sk_live_),不是火山 AK/SK。
  • Base URLhttps://www.silvamux.com/api/v3(平台域名),不是火山方舟域名。
  • model:使用模型广场或模型列表展示的真实调用名,不是火山 endpoint ID。
  • 任务查询:通过轮询 GET /api/v3/contents/generations/tasks/:id 查询任务状态。