Skip to main content
POST
创建素材

简介

在素材组内创建素材。Content-Type: application/json仅支持公网 https URL(BytePlus 须能直接拉取),不支持 Base64 / Data URI / multipart 直传。本地文件请先上传至 OSS / TOS / S3 等对象存储。 虚拟(aigc)与真人(liveness_face)素材库均支持 Image / Video / Audio。创建后 statuspending,轮询至 active(通常 1~3 分钟)后再用于 asset://
火山方舟 CreateAsset 自 2026 年起已下线 Base64 直传。详见 Create an Asset

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx

请求参数

string
必填
公网 https 资源地址;网关原样透传给上游
string
必填
素材组 ID(来自 创建素材组创建素材组(真人)
string
默认值:"Image"
Image / Video / Audio,大小写不敏感
string
素材名称(≤ 64 字符,仅用于展示与列表搜索,不参与模型推理)

格式与大小约束

图片 (Image)

视频 (Video)

音频 (Audio)

网关仅做 URL 后缀校验;尺寸/时长等由 BytePlus 异步完成,不达标时 status 变为 failed

请求示例

图片、视频、音频请求体结构相同,仅 asset_type 与 URL 不同:

响应示例

下一步:列出素材查询单个素材 轮询状态。