面向 AI 助手：本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/create-asset-api.md，全部文档索引见 https://ark.volcengine.com/llms.txt。

创建素材资产

POST https://ark.cn-beijing.volcengineapi.com/?Action=CreateAsset&Version=2024-01-01

在指定的 Asset Group（素材资产组合）内传入 Asset（素材资产）。

鉴权#

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

  • Access Key 鉴权，请在 Access Key 管理 页面，获取 Access Key。本接口仅支持 Access Key 鉴权。

请求参数#

Body 参数#

AssetType string  |  素材类型

Asset（素材资产）的类型，支持传入图像、视频、音频。取值：

  • Image：图像；
  • Video：视频；
  • Audio：音频
GroupId string  |  所属素材组 ID

Asset（素材资产）所属的 Asset Group（素材资产组合）的 Id

Name string  |  素材名称

Asset（素材资产）的名称，上限为 64 个字符。

注意：该字段仅用于使用 ListAssets 接口时模糊搜索素材，不会被带入模型推理。关于如何使用素材生成视频，请参考 使用预置虚拟人像 和 常见问题 4。

ProjectName string 默认值 default  |  所属项目

资源所属的项目名称。若资源不在默认项目中，需填写正确的项目名称。

注意：需要和待传入的 Asset Group（素材资产组合）的 ProjectName 保持一致。

URL string  |  素材 URL

传入的 Asset（素材资产）的公共可访问地址（URL）

响应参数#

Id string  |  素材 ID

Asset（素材资产）的 Id（Asset ID）