Руководство по функциям платформы

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

Главная страница и каталог моделей

Главная страница и верхние точки входа в продукты предоставляют доступ к консоли, руководству пользователя, каталогу моделей и LocoPal Creation. Каталог моделей централизованно показывает названия моделей, возможности, параметры и подробности биллинга.

При выборе модели последовательно проверьте:

1. возможности модели соответствуют типу задачи, например для видеозадачи выбирается видеомодель;
2. ID модели присутствует в ответе /v1/models текущего API Key;
3. параметры запроса входят в поддерживаемый диапазон, указанный в деталях модели;
4. ожидаемая цена укладывается в бюджет, окончательная сумма определяется фактическим счётом.

Обзор консоли

Консоль предназначена для просмотра баланса, тарифа, объёма вызовов, динамики расхода и последних записей. Статистика помогает выявить модели с высоким расходом и аномальные пики, а детализация счёта — сверить итоговую стоимость.

Ключи API

API Key — единственный способ аутентификации при вызове интерфейсов моделей, изображений, видео, аудио и материалов; один и тот же Key подходит для всех интерфейсов. Рекомендуется создавать отдельные ключи для «рабочего сервиса», «тестовой среды» и «клиентского приложения», задавая понятные имена, квоты и сроки действия.

Удаление или отключение Key не удаляет материалы, задачи и историю аккаунта; после создания нового Key можно продолжать использовать прежние материалы.

Журнал использования и журнал задач

Журнал использования фиксирует синхронные вызовы и поддерживает фильтрацию по времени, API Key, модели, группе, идентификатору запроса и статусу. Журнал задач предназначен для асинхронных задач, таких как видео и аудио; после создания задачи сохраняйте её ID. Изменение времени ожидания не означает повторного списания — новая идентичность задачи возникает только при повторном создании.

Журнал задач показывает время отправки, ID задачи (включая номер задачи в upstream), длительность, статус, прогресс и подробности. После успешного завершения задачи в столбце «Подробности» появляется «Нажмите, чтобы просмотреть видео» — по нажатию сгенерированное видео воспроизводится прямо во всплывающем окне, где можно скопировать адрес воспроизведения, не скачивая файл. Администраторы также могут просматривать задачи других аккаунтов в журнале задач с тем же прямым просмотром.

Журнал показывает только записи текущего аккаунта.

Управление библиотекой материалов

Библиотека материалов — это набор групп материалов с двумя категориями: виртуальные персонажи и материалы реальных людей.

Виртуальные персонажи

1. Нажмите «Создать группу», выберите «Виртуальный портрет», заполните название и описание группы (и название, и описание можно оставить пустыми — в этом случае платформа назовёт группу автоматически, например «Материал виртуального портрета 09-11 21:05»);
2. внутри группы нажмите «Загрузить изображение», чтобы выбрать локальное изображение, или «Отправить материал», чтобы указать публично доступный адрес изображения http(s);
3. отправка материала обрабатывается асинхронно; когда статус станет «Доступен», материал можно стабильно использовать в моделях, поддерживающих ссылки на материалы;
4. поддерживаются переименование материала, обновление статуса и удаление; перед удалением группы нужно сначала убрать или удалить материалы внутри неё.

При отправке материала поле «Название материала» также можно оставить пустым — платформа назовёт материал по имени загруженного файла; если нужно другое имя, переименуйте материал в списке.

Материалы реальных людей

Материалы реальных людей должны быть собраны и авторизованы самим человеком на мобильном телефоне:

1. нажмите «Создать группу» и выберите «Библиотека материалов реальных людей»;
2. прочитайте и отметьте соглашение об авторизации, создайте QR-код;
3. пусть сам человек отсканирует QR-код телефоном, пройдёт сбор данных, авторизацию и заполнение информации;
4. вернитесь на веб-страницу и нажмите «Сканирование завершено, начать синхронизацию»;
5. страница покажет группу реального человека и материалы, созданные при сборе; если они ещё обрабатываются, обновите страницу позже.

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

Поиск и фильтрация

• Поиск: и список групп, и список материалов поддерживают поиск по названию или ID;
• Фильтрация: можно фильтровать по типу группы и принадлежности к модели — показывать только группы и материалы, используемые для определённой модели;
• Принадлежность к модели: в списке отображается только название первой модели и счётчик +N; при наведении курсора показывается полный список моделей, к которым относится группа или материал;
• Пагинация: список загружается постранично, внизу показывается общее число записей и можно выбрать 10 / 20 / 50 / 100 записей на страницу (по умолчанию 10);
• Обновление: повторно считывает названия, статусы, сообщения об ошибках и адреса доступа групп и материалов текущего аккаунта.

Материал нужно загрузить в библиотеку только один раз

Не нужно создавать отдельные группы или загружать материалы для каждой модели. При загрузке материал попадает в единую библиотеку платформы, и все модели, поддерживающие ссылки на материалы, используют один и тот же экземпляр; ID материала не меняется, поэтому его можно напрямую переиспользовать между моделями без ожидания синхронизации на стороне модели. Соответствие моделей и библиотеки материалов описано в разделе Интерфейсы библиотеки материалов.

Ранее загруженные материалы будут один раз подготовлены платформой при первом обращении к ним из модели; после подготовки они ведут себя так же, как материалы, на которые ссылаются напрямую.

Проверка по библиотекам (администратор)

В верхней части страницы управления библиотекой материалов администратор может переключаться между «Библиотекой платформы» и библиотеками отдельных моделей: после переключения на библиотеку модели группы и материалы этой библиотеки доступны только для чтения (по умолчанию отображается только название модели), а также можно создавать группы и отправлять материалы прямо в библиотеке для особой подготовки и диагностики. Отправка материалов в библиотеке также поддерживает прямую загрузку изображений; если название оставить пустым, оно будет присвоено по имени файла.

Баланс, пополнение и счета

Страница баланса используется для пополнения, просмотра тарифа и активации льгот. Каталог моделей показывает ориентировочные цены, а счёт после выполнения задачи — окончательный расчёт. При проверке аномальных списаний используйте ID задачи, идентификатор запроса, ID модели и диапазон времени; не передавайте полный ключ.

LocoPal Creation

• LocoPal Creation: рабочая среда для прямого создания с интеллектуальным режимом, AI-рисованием, AI-видео, AI-аудио, короткометражками, работами, материалами и промптами;

Creation использует тот же аккаунт LocoPal и те же модельные сервисы; результаты генерации, задачи и материалы изолированы по текущему вошедшему пользователю.

Типичные рабочие процессы

Интеграция API

Создайте API Key → проверьте модели → выполните тестовый вызов → сверьте в журнале → подключите к бизнес-сервису → настройте таймауты и обработку ошибок.

Несколько изображений и референсное видео

Подготовьте публичные медиа или материалы со статусом «Доступен» → создайте асинхронную видеозадачу → сохраните ID задачи → опрашивайте до конечного состояния → скачайте или сохраните результат.

Видео с реальным человеком

Создайте сеанс авторизации реального человека → человек проходит сбор данных по QR-коду → разберите сеанс → проверьте статус материала реального человека → после доступности материала отправьте видеозадачу с поддержкой библиотеки материалов реальных людей.