LocoPal Ai (API-платформа)

Точка входа: https://locopalai.com

LocoPal Ai — ядро и единственный поставщик идентичности для всех приложений LocoPal: аккаунт, вход, баланс, каталог моделей, библиотека материалов и записи задач находятся здесь, а остальные приложения проходят единую аутентификацию через него.

Базовый адрес по умолчанию:

Сценарий	Адрес
Сети материкового Китая и внутренние модели	`https://locopalai.com`
Зарубежные модели или адрес доступа, указанный в консоли	`https://us-api.locopalai.com`

Если консоль показывает другой адрес доступа, ориентируйтесь на текущую консоль.

Основные функции консоли

Меню	Назначение
Панель данных	Расход, потребление и динамика вызовов
Ключи API	Создание/отключение API Key, настройка доступных групп и квот
Журнал использования	Детализация каждого вызова API (модель, token, стоимость)
Журнал задач	Детализация выполнения асинхронных задач (видео/аудио и т. д.) (см. ниже)
Управление материалами	Единая библиотека материалов платформы: группы, материалы, референсные изображения, портретные материалы
Управление AccessKey	Учётные данные доступа для интеграции материалов со сторонними системами
Кошелёк	Пополнение, тарифы, заказы и счета
Системные настройки (администратор)	Каналы, модели, цены групп, политики входа и безопасности

Группы и видимость моделей

Доступность модели зависит от группы: в группе есть несколько каналов, а к каналам привязаны модели.

Цены групп: настройка ценового коэффициента для каждой группы;
Автоматический порядок групп: список групп для API-ключа с правилом «пробовать по порядку»; если предыдущая группа недоступна, происходит переход к следующей;
Каталог моделей: просмотр фактически доступных названий моделей, возможностей и параметров.

После изменения групп или каналов в админке выпадающие списки моделей в Creation обновляются в реальном времени — достаточно обновить страницу, переразвёртывание не требуется.

Описание полей журнала задач

Журнал задач используется для диагностики асинхронных задач генерации (видео, аудио и т. д.); полный набор полей:

Поле	Описание
Время отправки	Момент отправки задачи; во второй строке — время завершения
Канал	Канал, фактически выполнявший задачу (видно администратору)
Пользователь	Пользователь, которому принадлежит задача (видно администратору)
ID задачи	ID задачи платформы; во второй строке — платформа/действие, в третьей — ID задачи в upstream
Длительность	Время от отправки до завершения
Статус	В очереди / генерация / успех / ошибка
Прогресс	Процент прогресса, возвращённый upstream
Артефакт	Результат задачи; можно сразу просмотреть или скачать изображение/видео/аудио
Подробности	Содержание запроса и сообщение об ошибке

Что видно в подробностях

Нажатие на запрос открывает снимок запроса этой задачи:

верхняя часть — содержание запроса: модель, промпт и параметры генерации (длительность, пропорции, разрешение и т. д.). Слишком длинный промпт автоматически сворачивается; нажмите «Показать всё», чтобы развернуть;
нижняя часть — JSON запроса: сохраняется как есть, без обрезки; в правом верхнем углу можно скопировать одним нажатием, чтобы передать в upstream для диагностики.

Сообщение об ошибке также находится в столбце Подробности; если оно слишком длинное, в списке оно обрезается — откройте его, чтобы увидеть полный текст.

Права доступа: содержание запроса и JSON запроса относятся к пользовательским данным и видны только администраторам. Когда обычный пользователь просматривает свой журнал задач, API не передаёт эти поля.

Дальнейшие шаги

Хотите сначала выполнить один вызов → Быстрый старт
Хотите узнать детали интерфейсов → Обзор API
Хотите управлять материалами → Руководство по библиотеке материалов