# 创建素材资产

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

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

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

> **注意**
>
> 上传素材（CreateAsset）API 为异步接口，系统处理可能出现排队，导致入库时间增加。不承诺上传时间 SLA。
> 视频类素材处理时间更长。

## 鉴权

本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。

* Access Key 鉴权，请在 [Access Key 管理](https://console.volcengine.com/iam/keymanage) 页面，获取 Access Key。本接口仅支持 Access Key 鉴权。

---

<span id="request-parameters"></span>
## 请求参数

### Body 参数

**AssetType** `string` | 素材类型

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

> **说明**
>
> - 传入方式说明：图像、视频、音频素材时，仅支持上传 URL，不支持 Base64。
>
> - 图片格式说明
>   * 格式：jpeg、png、webp、tiff、gif、heic、heif
>   * 宽高比（宽/高）：(0.4, 2.5)
>   * 宽高长度（px）：(300, 6000)
>   * 大小：单张图片小于 30 MB
>
> - 视频格式说明
>   * 格式：mp4、mov
>   * 分辨率：480p、720p、1080p、4K
>   * 时长：单个视频时长 [2, 30] s
>   * 尺寸：
>     * 宽高比（宽/高）：[0.4, 2.5]
>     * 宽高长度（px）：[300, 6000]
>     * 总像素数：宽×高 ∈ [407696, 8295044]
>   * 大小：单个视频不超过 200 MB
>   * 帧率（FPS）：[24, 60]
>
> 音频格式说明
> * 格式：wav、mp3
> * 时长：单个音频时长 [2, 30] s
> * 大小：单个音频不超过 15 MB
>
> 不同模型支持的输入音视频时长不同。建议在上传前记录上传音视频的时长，方便终端客户区分哪些素材可以在 Seedance 2.0  和 Seedance 2.5 系列模型中使用。

**GroupId** `string` | 所属素材组 ID

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

**Name** `string` | 素材名称

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

**注意**：该字段仅用于使用 *ListAssets* 接口时模糊搜索素材，不会被带入模型推理。关于如何使用素材生成视频，请参考 [使用预置虚拟人像](/docs/seedance-portrait-asset-guide#preset-avatar) 和 [常见问题 4](/docs/private-virtual-avatar-library-guide-preview)。

**ProjectName** `string` `默认值 default` | 所属项目

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

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

**URL** `string` | 素材 URL

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

## 响应参数

**Id** `string` | 素材 ID

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


## 代码示例

## 默认

### cURL

#### Request

```bash
curl 'https://ark.cn-beijing.volcengineapi.com/?Action=CreateAsset&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
    "GroupId": "group-20240514212750-b5e9m",
    "URL": "https://example-tos.cn-beijing.volcengine.com/asset-20240514212750-a3f8k.jpg",
    "Name": "demo-portrait-image",
    "AssetType": "Image",
    "ProjectName": "default"
}
'
```

#### Response

```
{
    "ResponseMetadata": {
        "RequestId": "20240514212750A1B2C3D4E5F6789ABC",
        "Action": "CreateAsset",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "Id": "asset-20240514212750-a3f8k"
    }
}
```