创建真人认证 H5 会话

POST

/api/material

创建真人资产组认证会话：返回 H5 认证链接与二维码。用户在手机端完成实名认证后，再用返回的 BytedToken 轮询 GetVisualValidateResult 拿资产组 GroupId。

实际请求：POST /api/material?Action=CreateVisualValidateSession（无需请求体，传 {} 即可）
渠道粘性：网关在创建会话时把 BytedToken 与所用渠道绑定，轮询务必用同一 BytedToken；多渠道部署建议用绑定渠道的 token（sk-xxx-<channelId>）。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

Body 参数application/json

示例

{}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://jiniu.ai/api/material?Action=CreateVisualValidateSession' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "ResponseMetadata": {
        "RequestId": "20260625...",
        "Action": "CreateVisualValidateSession",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "BytedToken": "2026062515501465178B138B02A64E1A",
        "H5Link": "https://ark.volcengine.com/.../authorization?pl=...&uid=...",
        "QrCode": "data:image/png;base64,iVBORw..."
    }
}

修改于 2026-06-29 12:34:01

删除素材

查询真人认证结果