Skip to main content
POST
cURL

授权

Authorization
string
header
必填

请求头鉴权,格式为 Bearer <token>,其中 <token> 为您的 API Key。

请求体

model
enum<string>
必填

标准请求使用 volc-asset-video;对于特定内容请求,请选择 Direct 资源下的 volc-asset-video-nsfw。

可用选项:
volc-asset-video,
volc-asset-video-nsfw
示例:

"volc-asset-video"

GroupId
string
必填

素材组 ID。

示例:

"group-20260319072926-rrnmg"

AssetType
enum<string>
必填

素材类型,视频固定传 Video。支持 MP4、MOV;分辨率为 480p、720p、1080p 或 4K;时长 2–30 秒;宽高比 0.4–2.5;宽和高均为 300–6000 px;总像素数为 407696–2086876;单个视频不超过 200 MB;帧率 24–60 FPS。以上限制需同时满足。

可用选项:
Video
示例:

"Video"

URL
string
必填

公共可访问的视频 URL,不支持视频 Base64。引用的视频文件必须满足 AssetType 中列出的视频限制。

示例:

"https://example.com/video.mp4"

Name
string

素材名称,最长 64 个字符。仅用于 ListAssets 模糊搜索,不会带入模型推理。

Maximum string length: 64
示例:

"scene-clip"

ProjectName
string
默认值:default

素材所属项目,必须与目标素材组的 ProjectName 一致;默认项目可省略。

示例:

"default"

响应

视频已进入异步处理流程。请轮询 GetAsset,直到 Status 变为 Active 或 Failed;接口不承诺上传时间 SLA。理想情况下视频通常需要 9–12 秒,审核队列拥塞时可能延迟约 10 秒到 2 分钟。

Id
string

素材 ID。Status 变为 Active 后,在 Seedance 请求中使用 asset://<ID>,不要使用临时的 GetAsset URL。

示例:

"asset-20260320120147-pqwhc"