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. 真人人像素材接口

2-使用BytedToken获取GroupId

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

作用#

根据 bytedToken 获取 GroupId。

使用方式#

从 Step 1 的 callback 参数中读取 bytedToken
调用本接口,从返回体 Result.GroupId 获取素材组 ID

下一步#

后续上传和管理素材时,请使用这个 GroupId。

请求参数

Query 参数

Header 参数

Body 参数application/json必填

示例
{
  "BytedToken": "<BYTED_TOKEN>"
}

请求示例代码

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=GetVisualValidateResult&Version=2024-01-01' \
--header 'Authorization: Bearer <ApiKey>' \
--header 'Content-Type: application/json' \
--data '{
  "BytedToken": "<BYTED_TOKEN>"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
  "ResponseMetadata": {
    "RequestId": "202604290007120ED13834E6A5EEAF9F7C",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "GroupId": "group-20260429000614-xxx"
  }
}
修改于 2026-05-13 02:18:04
上一页
1-创建真人认证H5链接
下一页
3-上传素材URL创建Asset
Built with