创建视频素材

状态

本文记录已接入的 Modelflare 素材管理接口。调用需要有效的媒体 API Key、可用媒体渠道和对应权限。

接口

POST https://modelflare.dev/volc/asset/CreateAsset

鉴权

使用 Modelflare API Key：

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

创建、更新和删除请求建议携带 Idempotency-Key。同一用户使用相同 Key 重试时，网关会重放已保存响应，不重复创建或删除。

请求

向已有素材组添加视频。处理完成后，返回的素材 ID 可用于支持该能力的 Seedance 工作流。

字段	类型	必填	说明	示例
`GroupId`	`string`	是	目标素材组 ID。	`group-20260320141746-zsf6b`
`AssetType`	`Video`	是	固定传 `Video`。	`Video`
`URL`	`string`	是	公共视频 URL，不支持视频 Base64。使用 MP4 或 MOV，时长 2–30 秒、24–60 FPS、宽高均为 300–6000 px、宽高比为 0.4–2.5、480p/720p/1080p/4K、总像素数 407696–2086876，且不超过 200 MB。	`https://example.com/video.mp4`
`file`	`binary`	否	multipart 的 `URL` 替代方式，限制与 `URL` 相同。	`video.mp4`
`Name`	`string`	否	展示和搜索名称，最多 64 个字符。	`scene-clip`
`model`	`string`	是	标准路由使用 `volc-asset-video`；单独授权的敏感内容路由使用 `volc-asset-video-nsfw`。	`volc-asset-video`
`ProjectName`	`string`	否	项目名称，必须与素材组一致，默认值为 `default`。	`default`

JSON 示例：

{
  "model": "volc-asset-video",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "scene-clip",
  "AssetType": "Video",
  "URL": "https://example.com/video.mp4",
  "ProjectName": "default"
}

multipart/form-data 示例：

curl --request POST https://modelflare.dev/volc/asset/CreateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --form "model=volc-asset-video" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@video.mp4"

响应

视频已进入异步处理。请轮询 GetAsset，直到 Status 变为 Active 或 Failed。接口不承诺上传时间 SLA；视频通常需要约 9–12 秒，审核队列繁忙时可能延迟约 10 秒到 2 分钟。

字段	类型	必填	说明	示例
`Id`	`string`	是	素材 ID。只有状态为 `Active` 后才能用 `asset://<ID>` 引用。	`asset-20260528140922-d9646`

响应示例：

{
  "Id": "asset-20260528140922-d9646"
}

错误

状态码	含义
`400`	请求参数无效。
`401`	API Key 缺失或未授权。

错误体示例（接口返回时）：

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

创建图片、视频和音频是异步的：收到素材 ID 后，先调用 GetAsset，只有 Active 状态才能把它放进 Seedance 的 asset://<ID> 引用。