Seedance 接入指南

Seedance 视频生成使用 /video/generations 接口：

txt

POST https://mux.la/video/generations
GET https://mux.la/video/generations/{task_id}

模型名称请从 Muxla 控制台的模型列表中复制。

请求头

http

Content-Type: application/json
Authorization: Bearer {API_KEY}

{API_KEY} 填写你的 Muxla Token。

素材库配置

如果 Seedance 请求需要使用参考图片、人物素材或私域素材，请先按素材库透传网关使用文档完成素材配置。

素材库接口统一使用：

txt

POST https://ark-api.mux.la/v1/volc/ark?Action={ACTION}&Version=2024-01-01

常用流程：

调用 CreateAssetGroup 创建素材分组，拿到 hbg- 开头的分组 ID。
调用 CreateAsset 传入公网可访问素材 URL，拿到 hb- 开头的素材 ID。
调用 GetAsset 轮询素材状态，直到 Status 为 Active。
在视频生成请求中使用已入库且状态为 Active 的素材。

客户端只使用平台脱敏 ID：素材 ID 使用 hb- 前缀，分组 ID 使用 hbg- 前缀。不要把火山真实 ID 传给业务接口。

创建视频任务

bash

curl "https://mux.la/video/generations" \
  -H "Authorization: Bearer 你的 Muxla Token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-video",
    "prompt": "生成一段 5 秒的产品展示视频，镜头从左到右缓慢移动，光线自然。",
    "duration": 5,
    "ratio": "16:9"
  }'

带参考素材

参考素材字段以网关实际支持为准。使用素材库时，请传入 hb- 开头的素材 ID：

json

{
  "model": "seedance-video",
  "prompt": "参考这个人物素材，生成一段自然转身的短视频。",
  "duration": 5,
  "ratio": "9:16",
  "asset_id": "hb-MnP48NWmWCa3S3zYJNZ9"
}

常用请求字段

字段	必填	说明
`model`	是	Seedance 视频模型名称，请从控制台复制
`prompt`	是	视频生成提示词
`duration`	否	视频时长；具体支持范围以网关返回为准
`seconds`	否	部分兼容请求可能使用该字段表达时长
`ratio`	否	输出宽高比，例如 `"16:9"`、`"9:16"`
`size`	否	部分兼容请求可能使用该字段表达尺寸
`asset_id`	否	素材库中 `hb-` 开头的素材 ID

查询任务状态

bash

curl "https://mux.la/video/generations/video_task_123" \
  -H "Authorization: Bearer 你的 Muxla Token"

常见状态包括：

状态	说明
`queued`	任务已创建，等待处理
`processing`	任务处理中
`completed`	任务完成，可读取结果
`failed`	任务失败，请查看错误信息

返回说明

创建任务和查询任务的响应字段以网关真实返回为准。任务完成后，结果可能是视频 URL、文件引用或结果数组。

如果任务失败，请读取响应中的 error.code 和 error.message。

Seedance 接入指南 ​

请求头 ​

素材库配置 ​

创建视频任务 ​

带参考素材 ​

常用请求字段 ​

查询任务状态 ​

返回说明 ​