Skip to main content
POST
cURL

授权

Authorization
string
header
必填

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

请求体

model
enum<string>
必填

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

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

"volc-asset-audio"

GroupId
string
必填

素材组 ID。

示例:

"group-20260319072926-rrnmg"

AssetType
enum<string>
必填

素材类型,音频固定传 Audio。支持 WAV、MP3;单段音频时长 2–30 秒,大小不超过 15 MB。

可用选项:
Audio
示例:

"Audio"

URL
string
必填

音频来源。AnyFast 支持公共可访问 URL、Data URI 或纯 Base64 字符串;音频必须是 WAV 或 MP3,时长 2–30 秒,大小不超过 15 MB。大文件请勿使用 Base64。

示例:

"https://example.com/audio.mp3"

Name
string

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

Maximum string length: 64
示例:

"background-music"

ProjectName
string
默认值:default

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

示例:

"default"

响应

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

Id
string

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

示例:

"asset-20260320120147-pqwhc"