---
title: "创建真人认证会话"
method: POST
path: "/api/ai/volcengine/assets/visual-validation-sessions"
tags: ["AI 服务/真人认证"]
---

# 创建真人认证会话

`POST /api/ai/volcengine/assets/visual-validation-sessions`

## Request

- Base URL: `https://aitoearn.cn`
- URL: `https://aitoearn.cn/api/ai/volcengine/assets/visual-validation-sessions`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/aitoearn/apis/aitoearn-api/docs/api/ai/volcengine/assets/visual-validation-sessions/post.ts> (a function with typed inputs; its response is checked against the schema)

创建真人活体认证会话。请求体只有 `callbackUrl`，不要传虚拟人像的 `name`、`description` 或 `avatarType`。认证完成后，AiToEarn 会把浏览器重定向到 `callbackUrl`，并附带认证结果参数。创建和完成同一会话必须使用同一个 API Key。

## Request body

- object
  - `callbackUrl` string, uri, required: 认证完成后跳转的 HTTP(S) 地址。

## Response `200`

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

- object
  - `data` object
    - `bytedToken` string, required: 真人认证会话 Token。
    - `h5Link` string, uri, required: 真人认证 H5 地址。
    - `shortLink` string, uri, required: 适合生成二维码的真人认证短链接。
    - `callbackUrl` string, uri, required: 认证完成后的跳转地址。
  - `code` integer, required: 业务状态码。0 表示成功，非 0 表示业务错误。
  - `message` string, required: 响应消息。
  - `requestId` string: 请求 ID。
  - `timestamp` integer: 错误响应时间戳，Unix 毫秒。

## Changes

- **2026-11-03** `7cc8f21c4c96`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/aitoearn/apis/aitoearn-api/changes/api/ai/volcengine/assets/visual-validation-sessions/post.md)

---

[API](https://skmtc.dev/aitoearn/apis/aitoearn-api.md) - [All operations](https://skmtc.dev/aitoearn/apis/aitoearn-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aitoearn/apis/aitoearn-api/revisions/7cc8f21c4c96?raw)