> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aitoearn.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建真人认证会话

> 创建真人活体认证会话。认证完成后，AiToEarn 会把浏览器重定向到 `callbackUrl`，并附带认证结果参数。创建和完成同一会话必须使用同一个 API Key。



## OpenAPI

````yaml /openapi/zh/aitoearn.openapi.json post /api/ai/volcengine/assets/visual-validation-sessions
openapi: 3.0.1
info:
  title: AiToEarn 开放平台 API
  description: AiToEarn 开放平台 API，支持在中国站与国际站之间切换调试。业务是否成功以响应体 code === 0 为准。
  version: 1.0.0
  contact: {}
servers:
  - url: https://aitoearn.cn
    description: 中国站
  - url: https://aitoearn.ai
    description: 国际站
security: []
tags:
  - name: AI 服务
  - name: AI 服务/视频生成
  - name: AI 服务/图像生成
  - name: 渠道管理
  - name: 渠道管理/账号
  - name: 渠道管理/内容发布
  - name: 渠道管理/平台
  - name: 渠道管理/作品
  - name: 渠道管理/账号分组
  - name: 渠道管理/授权
  - name: 资源管理
  - name: AI 服务/大语言模型
  - name: AI 服务/真人素材
paths:
  /api/ai/volcengine/assets/visual-validation-sessions:
    post:
      tags:
        - AI 服务/真人素材
      summary: 创建真人认证会话
      description: >-
        创建真人活体认证会话。认证完成后，AiToEarn 会把浏览器重定向到
        `callbackUrl`，并附带认证结果参数。创建和完成同一会话必须使用同一个 API Key。
      operationId: VolcengineAssetsController_createVisualValidationSession
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                callbackUrl:
                  type: string
                  format: uri
                  description: 认证完成后跳转的 HTTP(S) 地址。
              required:
                - callbackUrl
              additionalProperties: false
            examples:
              default:
                summary: 请求示例
                value:
                  callbackUrl: https://example.com/real-person/callback
      responses:
        '200':
          description: 请求已被服务处理。业务是否成功以响应体 code === 0 为准。
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      bytedToken:
                        type: string
                        description: 真人认证会话 Token。
                        example: 20260902170610426DEDD5F07EEF7EF075
                      h5Link:
                        type: string
                        format: uri
                        description: 真人认证 H5 地址。
                        example: >-
                          https://ark.volcengine.com/region:cn-beijing/mobile/liveness-face-manage/authorization
                      shortLink:
                        type: string
                        format: uri
                        description: 适合生成二维码的真人认证短链接。
                        example: https://aitoearn.cn/s/example
                      callbackUrl:
                        type: string
                        format: uri
                        description: 认证完成后的跳转地址。
                        example: https://example.com/real-person/callback
                    required:
                      - bytedToken
                      - h5Link
                      - shortLink
                      - callbackUrl
                    additionalProperties: false
                  code:
                    type: integer
                    description: 业务状态码。0 表示成功，非 0 表示业务错误。
                  message:
                    type: string
                    description: 响应消息。
                  requestId:
                    type: string
                    description: 请求 ID。
                  timestamp:
                    type: integer
                    description: 错误响应时间戳，Unix 毫秒。
                required:
                  - code
                  - message
              examples:
                success:
                  summary: 成功
                  value:
                    code: 0
                    message: 请求成功
                    data:
                      bytedToken: 20260902170610426DEDD5F07EEF7EF075
                      h5Link: >-
                        https://ark.volcengine.com/region:cn-beijing/mobile/liveness-face-manage/authorization
                      shortLink: https://aitoearn.cn/s/example
                      callbackUrl: https://example.com/real-person/callback
                validationFailed10002:
                  summary: ValidationFailed (10002)
                  value:
                    code: 10002
                    message: 参数验证失败
                    data: {}
                    timestamp: 1772099056662
                unauthorized401:
                  summary: 未认证或 API Key 无效
                  value:
                    code: 401
                    message: Unauthorized
                    data: {}
                    timestamp: 1772099056662
      security:
        - apikey-header-X-Api-Key: []
components:
  securitySchemes:
    apikey-header-X-Api-Key:
      type: apiKey
      in: header
      name: X-Api-Key
      description: 需要从 AiToEarn 获取 API Key。点击前往[「API Key 获取教程」](/zh/use/api-key)。

````