OneLinkAI API 调用文档
OneLinkAI 官网模型广场
OneLinkAI 官网模型广场
  1. 真人人像素材接口
  • 使用指南
    • 产品简介
    • 快速开始
    • API文档
      • 模型接入指南
      • Vidu 系列模型接入
      • Kling 系列模型接入
      • Veo 模型接入
      • Nano Banana 模型接入
      • GPT Image 2 模型接入
      • 获取模型列表
        • OpenAI / Anthropic格式
        • Gemini格式
      • 大语言会话模型接入
        • OpenAI
        • OpenAI-Responses
        • Claude
        • Gemini
      • Seedance 模型接入
        • 火山方舟模型接入指南
        • Seedance2.0 真人人像素材使用
        • Seedance 2.0 私域虚拟人像素材使用
        • 真人人像素材接口
          • 1-创建真人认证H5链接
            POST
          • 2-使用BytedToken获取GroupId
            POST
          • 3-上传素材URL创建Asset
            POST
          • 4-查询素材状态
            POST
          • 5-查询素材列表 (可选)
            POST
          • 6-删除素材 (可选)
            POST
          • 7-删除素材组 (可选)
            POST
      • HappyHorse 模型接入
        • HappyHorse 文生视频
        • HappyHorse 图生视频
        • HappyHorse 参考生视频
        • HappyHorse 视频编辑
  • 开发工具
    • CC-Switch使用
    • Claude Code
    • Codex
    • Gemini
  • 关于我们
    • 商务合作
    • 联系我们
  • 服务条款
    • 用户协议
    • 隐私政策
    • 用户充值协议
    • 申请账号主体变更协议
    • 代理商服务协议
  1. 真人人像素材接口

5-查询素材列表 (可选)

POST
https://api.onelinkai.cloud/volc/openapi

作用#

查询素材列表。

常见用途#

按 GroupId 查询某个素材组下的全部素材
按状态筛选素材
做素材管理或排查

请求参数

Query 参数

Header 参数

Body 参数application/json必填

示例
{
  "Filter": {
    "GroupIds": ["<GROUP_ID>"],
    "GroupType": "LivenessFace",
    "Statuses": ["Active", "Processing", "Failed"]
  },
  "PageNumber": 1,
  "PageSize": 10,
  "SortBy": "GroupId",
  "SortOrder": "Asc"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.onelinkai.cloud/volc/openapi?Action=ListAssets&Version=2024-01-01' \
--header 'Authorization: Bearer <ApiKey>' \
--header 'Content-Type: application/json' \
--data '{
  "Filter": {
    "GroupIds": ["<GROUP_ID>"],
    "GroupType": "LivenessFace",
    "Statuses": ["Active", "Processing", "Failed"]
  },
  "PageNumber": 1,
  "PageSize": 10,
  "SortBy": "GroupId",
  "SortOrder": "Asc"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "ResponseMetadata": {
        "RequestId": "string",
        "Action": "string",
        "Version": "string",
        "Service": "string",
        "Region": "string"
    },
    "Result": {
        "Items": [
            {
                "Id": "string",
                "Name": "string",
                "URL": "string",
                "GroupId": "string",
                "AssetType": "string",
                "Status": "string",
                "Error": {
                    "Code": "string",
                    "Message": "string"
                },
                "ProjectName": "string",
                "CreateTime": "string",
                "UpdateTime": "string"
            }
        ],
        "TotalCount": 0,
        "PageNumber": 0,
        "PageSize": 0
    }
}
修改于 2026-05-13 02:18:04
上一页
4-查询素材状态
下一页
6-删除素材 (可选)
Built with