视频(Videos)原厂火山格式素材库
素材库总览
统一入口、鉴权、响应信封与 Action 一览
素材库不是 RESTful 接口,所有操作打同一个入口,用查询参数 Action 区分动作:
POST https://jiniu.ai/api/material?Action=<动作名>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json请求体是 JSON,字段随动作不同;不需要参数的动作发 {} 即可。
Action 一览
| 分类 | Action | 说明 |
|---|---|---|
| 素材组 | CreateAssetGroup | 创建素材组 |
| 素材组 | GetAssetGroup | 查询素材组 |
| 素材组 | UpdateAssetGroup | 修改素材组 |
| 素材组 | DeleteAssetGroup | 删除素材组 |
| 素材组 | ListAssetGroups | 列出素材组 |
| 素材 | CreateAsset | 上传素材 |
| 素材 | GetAsset | 查询素材 |
| 素材 | UpdateAsset | 修改素材 |
| 素材 | DeleteAsset | 删除素材 |
| 素材 | ListAssets | 列出素材 |
| 真人认证 | CreateVisualValidateSession | 创建认证会话 |
| 真人认证 | GetVisualValidateResult | 查询认证结果 |
| 真人认证 | CreateRealValidateH5 | 签发认证 H5 链接 |
响应信封
业务结果统一放在 Result 里:
{
"ResponseMetadata": { "RequestId": "…", "Action": "CreateAssetGroup" },
"Result": { "Id": "group-xxxx" }
}业务失败时 Result.Error 非空:
{
"ResponseMetadata": { "RequestId": "…", "Action": "CreateAsset" },
"Result": { "Error": { "Code": "InvalidParameter", "Message": "AssetType must be one of Image/Video/Audio" } }
}网关层面的失败(无可用渠道、上游不可达等)走标准错误结构,HTTP 状态码为 4xx / 5xx。
计费
素材库接口是纯透传:不计 token、不计费、不写消费日志。
渠道亲和
素材和素材组创建在哪个渠道,后续对它的操作就回到同一个渠道——网关按请求体里的 Id 做亲和匹配。跨密钥、跨分组访问同一份素材不一定成功,以实际分组配置为准。
ListAssetGroups 与 ListAssets 是网关基于本地归属索引实现的,按当前用户隔离、不转发上游,因此只能看到通过本网关创建的记录。