Библиотека материаловИнтерфейсы библиотеки материалов
Руководство
Авторизация материалов реальных людей
Создание сессии сканирования QR-кода реальным человеком и подтверждение завершения сбора данных
Авторизация материалов реальных людей
Материалы реальных людей должны пройти сбор данных и авторизацию на мобильном телефоне самого человека; обычная загрузка изображения не может это заменить.
Создание сессии сканирования QR-кода реальным человеком
POST
/api/v1/materials/portrait/sessionsАутентификация
Authorization: Bearer <API_KEY>.
Тело запроса · application/json
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
continuous_create | boolean | Нет | Если true, после завершения обработки продолжить создание следующей сессии авторизации |
Пример запроса
curl -X POST "$LOCOPAL_BASE_URL/api/v1/materials/portrait/sessions" \
-H "Authorization: Bearer $LOCOPAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"continuous_create":false}'Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
code | integer | При успехе — 0 |
msg | string | При успехе — 真人授权会话已创建 |
data.session.authorization_url | string | Адрес страницы авторизации; преобразуйте его в QR-код и передайте самому человеку |
data.session.session_token | string | Токен сессии; храните только на сервере |
data.session.expires_in | integer | Срок действия сессии (в секундах) |
data.session.expire_time | string | Время истечения сессии (строка времени ISO) |
Тело ответа
{
"code": 0,
"data": {
"session": {
"authorization_url": "https://授权页面地址",
"session_token": "session-token",
"expires_in": 600,
"expire_time": "2026-09-09T08:10:00.000Z"
}
},
"msg": "真人授权会话已创建"
}Не записывайте session_token в журналы, не передавайте другим учётным записям и не храните долго; после истечения сессии создайте новую.
Ответы с ошибками
| HTTP | msg | Описание |
|---|---|---|
400 | 请求体必须是 JSON 对象 | Тело запроса не является корректным JSON |
401 | Invalid token | API Key отсутствует, неверен или истёк |
503 | 素材服务暂不可用 | Канал сбора данных реальных людей не готов; сохраните время запроса и обратитесь в поддержку платформы |
Подтверждение завершения сканирования QR-кода реальным человеком
POST
/api/v1/materials/portrait/resolveАутентификация
Authorization: Bearer <API_KEY>.
Тело запроса · application/json
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
session_token | string | Да | data.session.session_token, возвращённый при создании сессии сканирования |
Пример запроса
curl -X POST "$LOCOPAL_BASE_URL/api/v1/materials/portrait/resolve" \
-H "Authorization: Bearer $LOCOPAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"session_token":"session-token"}'Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
code | integer | При успехе — 0 |
msg | string | При успехе — 真人授权已完成 |
data.group.id | string | ID группы материалов реального человека, созданной при сборе данных |
data.group.name | string | Название группы |
data.group.type | string | Всегда real |
data.group.description | string / null | Описание группы |
Тело ответа
{
"code": 0,
"data": {
"group": {
"id": "group-20260911034940-lrtht",
"name": "真人素材库",
"type": "real",
"description": null
}
},
"msg": "真人授权已完成"
}После успешной обработки вызовите синхронизацию статуса материалов и запросите список материалов, чтобы получить asset_id и status материалов реального человека.
Ответы с ошибками
| HTTP | msg | Описание |
|---|---|---|
400 | 请求体必须是 JSON 对象 | Тело запроса не является корректным JSON |
401 | Invalid token | API Key отсутствует, неверен или истёк |
503 | 素材服务暂不可用 | Сессия не существует, сбор данных ещё не завершён или канал сбора данных реальных людей не готов |
Эта страница была полезной?