素材库概览
素材库是 宁享Token 提供的 API Key 级功能，允许调用方管理图片、视频、音频等媒体素材，并通过素材组进行组织与隔离。所有素材数据按 client_key 隔离，不跨 API Key 共享。
核心特性
- 多类型支持：支持图片、视频、音频三类素材的上传、下载与引用。
- 素材组管理：通过素材组对素材进行逻辑分组（如真人组、AIGC 组），便于批量调用与权限控制。
- API Key 鉴权：所有素材端点均使用 API Key（Bearer Token）鉴权，与所属 API Key 绑定。
- 按 client_key 隔离：每个 API Key 拥有独立的素材空间，互不影响。
支持的素材类型
| 类型 | MIME 前缀 | 用途 |
|---|---|---|
image | image/* | 图像生成、图像编辑、数字人形象 |
video | video/* | 视频生成、视频驱动 |
audio | audio/* | 语音合成、声音克隆、视频驱动音轨 |
素材组
素材组是素材的容器，用于组织同类素材。常见分组：
- 真人组：真人形象 / 真人音色，通常用于真人驱动场景。
- AIGC 组：AI 生成的形象 / 音色，用于 AIGC 驱动场景。
一个素材必须归属且仅归属一个素材组。素材组可通过 素材组 CRUD 接口管理。
鉴权方式
所有素材端点使用 API Key 鉴权，通过 Authorization 头传入：
bash
Authorization: Bearer <your_api_key>API Key 即 client_key，素材数据自动归属该 key，无需额外指定租户字段。
端点总览
| 端点 | 方法 | 说明 | 文档 |
|---|---|---|---|
/api/assets/groups | GET / POST | 素材组列表 / 创建 | 素材组管理 |
/api/assets/groups/:id | PUT / DELETE | 更新 / 删除素材组 | 素材组管理 |
/api/assets/list | GET | 素材列表 | 素材管理 |
/api/assets | POST | 创建素材（URL 引用登记） | 素材管理 |
/api/assets/upload | POST | 直接上传素材文件（multipart/form-data） | 素材管理 |
/api/assets/:id | GET / PUT / DELETE | 获取 / 更新 / 删除素材 | 素材管理 |
/api/assets/:id/download | GET | 下载素材文件 | 素材管理 |
/api/assets/:id/public-url | GET | 按需签发公开下载 URL（2 小时） | — |
/api/assets/:id/optimize | POST | 通用素材升级为优化素材（link→library） | — |
/api/assets/tree | GET | 素材组 + 素材树形视图 | — |
/api/assets/summary | GET | 当前 Key 素材汇总 | — |
/api/assets/liveness/session | POST | 创建活体认证会话 | 真人活体认证 |
/api/assets/liveness/history | GET | 活体认证历史 | 真人活体认证 |
/api/assets/liveness/callback | GET | 活体认证回调（上游跳转，无鉴权） | 真人活体认证 |
/api/ark/assets | POST | 火山方舟素材托管端点（?Action=） | 方舟素材托管 |
Base URL
/ （部署域名，例如 https://your-domain.com）