Skip to main content
POST
cURL

授权

Authorization
string
header
必填

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

请求体

GroupId
string
必填

素材组 ID。

示例:

"group-20260319072926-rrnmg"

AssetType
enum<string>
必填

素材类型,图片固定传 Image。支持 JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF;单张图片小于 30 MB,宽高比为 0.4–2.5,宽和高均为 300–6000 px。

可用选项:
Image
示例:

"Image"

URL
string
必填

图片来源。AnyFast 支持公共可访问 URL、Data URI 或纯 Base64 字符串;大文件请勿使用 Base64。

示例:

"https://example.com/image.jpg"

model
enum<string>

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

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

"volc-asset"

Name
string

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

Maximum string length: 64
示例:

"character-reference"

ProjectName
string
默认值:default

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

示例:

"default"

响应

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

Id
string

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

示例:

"asset-20260320120147-pqwhc"