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

3-上传素材URL创建Asset

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

前置条件#

先完成 Step 1 和 Step 2,拿到 GroupId。

作用#

上传素材 URL,创建 Asset。

说明#

当前仅支持传素材 URL
每次请求上传一个素材文件
返回体 Result.Id 为 AssetId

下一步#

继续调用“4-查询素材状态”,直到 Status=Active。

请求参数

Query 参数

Header 参数

Body 参数application/json必填

示例
{
  "GroupId": "<GROUP_ID>",
  "URL": "https://your-cdn.example.com/materials/face-001.jpg",
  "AssetType": "Image",
  "Name": "face-001"
}

请求示例代码

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=CreateAsset&Version=2024-01-01' \
--header 'Authorization: Bearer <ApiKey>' \
--header 'Content-Type: application/json' \
--data '{
  "GroupId": "<GROUP_ID>",
  "URL": "https://your-cdn.example.com/materials/face-001.jpg",
  "AssetType": "Image",
  "Name": "face-001"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "ResponseMetadata": {
        "RequestId": "string",
        "Action": "string",
        "Version": "string",
        "Service": "string",
        "Region": "string"
    },
    "Result": {
        "Id": "string"
    }
}
修改于 2026-05-13 02:18:04
上一页
2-使用BytedToken获取GroupId
下一页
4-查询素材状态
Built with