---
title: "创建素材"
method: POST
path: "/api/ai/volcengine/assets/items"
tags: ["AI 服务/虚拟人像素材"]
---

# 创建素材

`POST /api/ai/volcengine/assets/items`

## Request

- Base URL: `https://aitoearn.cn`
- URL: `https://aitoearn.cn/api/ai/volcengine/assets/items`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/aitoearn/apis/aitoearn-api/docs/api/ai/volcengine/assets/items/post.ts> (a function with typed inputs; its response is checked against the schema)

把公网可访问的图片、视频或音频登记到素材组。创建后状态通常为 `Processing`，请通过“素材详情”接口刷新状态。

## Request body

- object
  - `groupId` string, required: 素材组 ID。虚拟人像填写创建虚拟人像组返回的 groupId。真人素材填写完成真人认证返回的 groupId。
  - `url` string, uri, required: 素材源文件 URL，必须可由公网访问。
  - `assetType` 'Image' | 'Video' | 'Audio', required: 素材类型。
  - `name` string: 素材名称。

## Response `200`

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

- object
  - `data` object
    - `assetId` string, required: 素材 ID。
    - `groupId` string, required: 素材组 ID。
    - `name` string: 素材名称。
    - `assetType` 'Image' | 'Video' | 'Audio', required: 素材类型。
    - `status` 'Processing' | 'Active' | 'Failed', required: 素材状态。只有 Active 状态的素材可以用于视频生成。
    - `url` string, uri: 素材源文件 URL。
    - `createdAt` string, date-time, required: 创建时间。
    - `updatedAt` string, date-time, required: 更新时间。
  - `code` integer, required: 业务状态码。0 表示成功，非 0 表示业务错误。
  - `message` string, required: 响应消息。
  - `requestId` string: 请求 ID。
  - `timestamp` integer: 错误响应时间戳，Unix 毫秒。

## Changes

- **2026-11-03** `7cc8f21c4c96`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/aitoearn/apis/aitoearn-api/changes/api/ai/volcengine/assets/items/post.md)

---

[API](https://skmtc.dev/aitoearn/apis/aitoearn-api.md) - [All operations](https://skmtc.dev/aitoearn/apis/aitoearn-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aitoearn/apis/aitoearn-api/revisions/7cc8f21c4c96?raw)