Jiniu AIJiniu AI
文档
视频(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 是网关基于本地归属索引实现的,按当前用户隔离、不转发上游,因此只能看到通过本网关创建的记录。