OpenAPI 参考

Modelink API · 火山素材兼容接口

兼容火山方舟私域虚拟人像与真人人像素材协议。客户端可以保留火山协议的 Action、请求体、响应信封和 V4 签名逻辑，只需将 Base URL 与凭据替换为 Modelink 提供的值。调用 Action 前，先使用 Bearer API Key 查询可用的 ProjectName。

版本 1.0.0

查询火山素材项目

GET

/v1/asset-projects

查询当前 API Key 可用的火山素材项目。响应中的 project_name 是后续所有 /volcengine/assets/ Action 请求必须使用的 ProjectName；不支持火山协议默认值 default。同一素材组、素材和视频任务必须使用相互匹配的项目与渠道。

BearerAuthBEARER

Modelink API Key。仅项目查询接口使用 Bearer 鉴权。

Bearer 格式：API Key

暂无请求体

GET/v1/asset-projects

curl https://api.qnaigc.com/v1/asset-projects \
  --header 'Authorization: Bearer YOUR_BEARER_AUTH' \
  --header 'Accept: application/json'

object

查询成功。没有可用素材项目时，data 为空数组。

- project_namestring, 必填
  Modelink 火山素材项目标识。必须先调用 GET /v1/asset-projects 获取；不支持 default，字段值区分大小写。
  pattern: ^cv1-[0-9a-z]{5}$
- - aigc
  - liveness_face

{
  "data": [
    {
      "project_name": "cv1-bogic",
      "supported_asset_types": [
        "aigc",
        "liveness_face"
      ]
    }
  ]
}