⑪ 生成真人认证链接

POST /v1/real-avatar/auth/session

MethodPOST
Path/v1/real-avatar/auth/session
Typehttp
Status1
Module2102810
Folder87318197

概览

MethodPOST
Path/v1/real-avatar/auth/session
Typehttp
Status1
Module2102810
Folder87318197

参数

{
  "path": [],
  "query": [],
  "cookie": [],
  "header": []
}

请求体

{
  "type": "application/json",
  "parameters": [],
  "jsonSchema": {
    "type": "object",
    "required": [
      "model",
      "CallbackURL"
    ],
    "properties": {
      "model": {
        "type": "string",
        "description": "路由选择参数(固定传此值)",
        "enum": [
          "doubao-seedance-2-0-260128",
          "doubao-seedance-2-0-fast-260128"
        ],
        "examples": [
          "doubao-seedance-2-0-260128"
        ]
      },
      "CallbackURL": {
        "type": "string",
        "format": "uri",
        "description": "演员认证完成后浏览器跳转地址(业务方自己的前端页面,必填)",
        "examples": [
          "https://your-app.com/volc-auth-done"
        ]
      },
      "Lng": {
        "type": "string",
        "enum": [
          "zh",
          "en",
          "zh-Hant"
        ],
        "default": "zh",
        "description": "H5 页面语言(可选)"
      }
    },
    "x-apifox-orders": [
      "model",
      "CallbackURL",
      "Lng"
    ]
  },
  "mediaType": "application/json",
  "oasExtensions": "",
  "required": true,
  "additionalContentTypes": []
}

响应

[
  {
    "id": 138296402,
    "name": "",
    "code": 200,
    "contentType": "json",
    "jsonSchema": {
      "type": "object",
      "properties": {
        "ResponseMetadata": {
          "type": "object",
          "properties": {
            "RequestId": {
              "type": "string",
              "examples": [
                "20260601191715C9DAA092032F19CEC367"
              ]
            },
            "Action": {
              "type": "string",
              "examples": [
                "CreateAssetGroup"
              ]
            },
            "Version": {
              "type": "string",
              "examples": [
                "2024-01-01"
              ]
            },
            "Service": {
              "type": "string",
              "examples": [
                "ark"
              ]
            },
            "Region": {
              "type": "string",
              "examples": [
                "cn-beijing"
              ]
            },
            "Error": {
              "type": "object",
              "properties": {
                "Code": {
                  "type": "string",
                  "examples": [
                    "AccessDenied"
                  ]
                },
                "Message": {
                  "type": "string"
                }
              },
              "x-apifox-orders": [
                "Code",
                "Message"
              ]
            }
          },
          "x-apifox-orders": [
            "RequestId",
            "Action",
            "Version",
            "Service",
            "Region",
            "Error"
          ]
        },
        "Result": {
          "type": "object",
          "properties": {
            "BytedToken": {
              "type": "string",
              "description": "保存此值,认证成功后传给接口⑫(120 秒有效)",
              "examples": [
                "202603311449168C23BA26XXXXXXXX"
              ]
            },
            "H5Link": {
              "type": "string",
              "description": "发给演员打开,完成真人认证",
              "examples": [
                "https://h5-v2.kych5.com?token=..."
              ]
            },
            "CallbackURL": {
              "type": "string",
              "description": "与请求一致"
            }
          },
          "x-apifox-orders": [
            "BytedToken",
            "H5Link",
            "CallbackURL"
          ]
        }
      },
      "x-apifox-orders": [
        "ResponseMetadata",
        "Result"
      ]
    },
    "itemSchema": {},
    "description": "成功,返回 H5Link 和 BytedToken",
    "mediaType": "application/json",
    "headers": [],
    "oasExtensions": ""
  }
]