视频生成 API

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

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

关键参数

认证： Authorization: Bearer <API_KEY> 或 x-api-key: <API_KEY>

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

文生视频

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": "doubao-seedance-1-5-pro-251215",
    "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": "doubao-seedance-1-5-pro-251215",
    "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": "doubao-seedance-1-5-pro-251215",
    "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": "doubao-seedance-1-5-pro-251215",
    "content": [
      {"type": "image_url", "image_url": {"url": "asset://AST-XXXX"}, "role": "reference_image"},
      {"type": "text", "text": "让画面中的角色跳舞"}
    ]
  }'

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

content 字段

文本（text）

图片（image_url）

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

视频（video_url）

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

音频（audio_url）

不可单独输入音频。

音频要求：格式 wav/mp3；时长 ≤15s，最多 3 段，总时长 ≤15s；单个 ≤15MB。

响应

创建任务返回任务 ID：

{
  "id": "VTK-01JXXXXXXXXXXXXXX",
  "model": "doubao-seedance-1-5-pro-251215",
  "status": "queued",
  "created_at": "2026-03-31T12:00:00Z"
}

查询任务

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

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。

取消任务

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

仅 queued 状态可取消。

生成样例

多模态参考生视频（背景图 + 妆造三视图 + 面部特写图 + 提示词）：

提示词：

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

素材准备与上传方式对生成效果影响显著，详见 素材选用指南。

可用模型

样例模型：doubao-seedance-1-5-pro-251215（视频）、doubao-seed3d-2.0（3D）。

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

计费

视频生成按模型与视频参数（分辨率、时长、是否配音）计费，具体单价调 GET /billing/models 接口。

与火山官方接口的差异

SilvaMux 的 Seedance 接口与火山官方接口字段相似（同款模型），但：

• 鉴权：用平台 API Key（sk_live_），不是火山 AK/SK。
• Base URL：https://www.silvamux.com/api/v3（平台域名），不是火山方舟域名。
• model：用平台调用名（如 doubao-seedance-1-5-pro-251215），不是火山 endpoint ID。
• 任务查询：通过轮询 GET /api/v3/contents/generations/tasks/:id 查询任务状态。