Помощь и справочник
На этой странице приведено единое описание терминов, встречающихся в документации и интерфейсе платформы,
чтобы один и тот же термин не назывался по-разному на разных страницах.
| Термин | Значение |
|---|
| LocoPal Ai | API-платформа и ядро всей экосистемы: аккаунт, вход, биллинг, каталог моделей, библиотека материалов и записи задач предоставляются ею. Точка входа — locopalai.com. |
| LocoPal Creation | Платформа создания (веб-рабочая среда) для непосредственного создания без написания кода. Точка входа — creation.locopalai.com. |
| Консоль | Интерфейс управления LocoPal Ai после входа, включающий каталог моделей, ключи API, журналы, управление библиотекой материалов, кошелёк и т. д. |
| Термин | Значение |
|---|
| API keys | Учётные данные для вызова интерфейсов платформы, вида sk-.... Один Key может вызывать интерфейсы моделей, изображений, видео, аудио и материалов. |
| Access Token | Краткосрочный токен вызова. Фронтенд платформы хранит его только в памяти и не записывает в localStorage. |
| Токен обновления / Cookie сеанса | Используется для восстановления состояния входа после обновления страницы. Область действия — .locopalai.com, поэтому обе платформы могут использовать общий вход. |
| Единый вход | Достаточно один раз войти в LocoPal Ai — остальные платформы автоматически получают состояние входа. LocoPal Ai — единственный источник идентичности. |
| Завершение сеанса | После выхода из аккаунта, переключения аккаунта или смены пароля сеансы на всех платформах одновременно завершаются, и требуется повторный вход. |
| Термин | Значение |
|---|
| ID модели | Значение, которое нужно указать в поле model запроса; берётся из data[].id, возвращаемого GET /v1/models. Это не отображаемое на странице название. |
| Каталог моделей | Точка входа для просмотра названий моделей, возможностей, параметров, цен и доступных групп. |
| Группа вызовов / группа | Права доступа, определяющие, какие модели видит и может вызывать Key. В группе есть несколько каналов, а к каналам привязаны модели. |
| Канал | Канал внутри группы, фактически обеспечивающий работу моделей. Доступность модели зависит от того, можно ли сейчас маршрутизировать запрос к доступному каналу. |
| Базовый адрес (Base URL) | Префикс интерфейса, например https://locopalai.com. Указывайте только домен, не добавляйте повторно /v1. |
us-api.locopalai.com | Резервный адрес доступа для зарубежных моделей или специфических сетевых условий. Какой адрес используется, по /v1/models того адреса и ориентируйтесь. |
| Синхронный вызов | Вызов, при котором результат получается сразу при возврате запроса, например текст, изображения, аудио. |
| Асинхронная задача | Вызов, при котором сначала создаётся задача и получается ID, а затем результат опрашивается, например генерация видео. |
| Термин | Значение |
|---|
| Библиотека материалов | Единое хранилище материалов платформы, организованное по группам. Достаточно добавить материал один раз, чтобы его могли использовать все модели, поддерживающие ссылки на материалы. |
| Группа материалов | Контейнер для материалов; бывает двух типов: виртуальная (virtual) и реального человека (real). |
| Виртуальный материал | Загруженное или сгенерированное изображение, подходящее для хранения переиспользуемых данных персонажей, товаров, стилей и т. п. |
| Материал реального человека | Данные реального человека, которые он сам должен собрать и авторизовать с помощью сканирования QR-кода на телефоне; обычная загрузка изображения их не заменяет. |
| ID материала | Уникальный идентификатор материала, одинаковый для разных моделей. |
asset://<asset_id> | Способ ссылки на добавленный в библиотеку материал в запросе. Используйте после того, как статус материала станет Active. |
Active | Один из статусов материала: обработка завершена, материал можно стабильно использовать в моделях, поддерживающих ссылки на материалы. |
Processing | Материал всё ещё обрабатывается. Это не ошибка — продолжайте опрашивать с тем же ID материала. |
data_url | Форма встроенной передачи данных изображения (data:image/...;base64,...); можно передать только одно из полей — data_url или image_url. |
| Термин | Значение |
|---|
| ID задачи | Идентификатор асинхронной задачи. После создания его необходимо сохранить; при локальном таймауте отслеживайте задачу запросами, а не повторным созданием. |
| Журнал задач | Точка входа для просмотра деталей выполнения асинхронных задач: время отправки, ID задачи, длительность, статус, прогресс и артефакты. |
| Журнал использования | Точка входа для просмотра деталей синхронных вызовов: модель, Token и расходы. |
queued / в очереди | Задача принята и ожидает выполнения. |
processing / генерация | Задача выполняется; можно покинуть страницу и позже вернуться к исходной записи. |
succeeded / завершено | Результат сгенерирован, его можно скачать или использовать как ссылку. |
failed / ошибка | Задача завершилась с ошибкой. Прочитайте error.code и error.message в том же ответе. |
video_generation_failed | Код окончательного сбоя видеозадачи; error.message уже содержит очищенную читаемую причину. |
| Артефакт | Продукт задачи: изображение, видео или аудио, которое можно сразу просмотреть или скачать. |
| Снимок запроса | Содержимое запроса задачи и исходный JSON запроса. Виден только администратору; при запросе своего задания обычным пользователем это поле не возвращается. |
| Термин | Значение |
|---|
| Тарификация по Token | Входные и выходные Token тарифицируются отдельно; единица отображается как 1K или 1M Token. |
| Кэшируемый ввод / запись в кэш | Статья тарификации, отображаемая только для моделей с поддержкой кэширования промптов. |
| Тарификация за вызов | Каждый успешный запрос тарифицируется по фиксированной цене. |
| Матрица цен | Таблица цен для видеомоделей по признакам «с видео на входе» × «выходное разрешение». |
| Расчёт при завершении | Фактическое списание за асинхронную задачу происходит при её завершении; отправка только принимает задачу и не списывает средства заранее. |
| Кошелёк | Точка входа для пополнения, тарифов, заказов и записей счетов. |
| Предварительная оценка расхода | Оценка стоимости перед отправкой задачи. Если баланса недостаточно, сразу возвращается сообщение и задача не создаётся. |
| Термин | Значение |
|---|
Ограничение частоты / 429 | Слишком много запросов. Повторите с задержкой по указанию, не повторяйте параллельно. |
task_concurrency_exceeded | Достигнут лимит параллельных задач. Сохраните ID существующих задач и повторите отправку по инициативе пользователя после ожидания. |
| Повторная попытка с задержкой | После ошибки подождите некоторое время и повторите, увеличивая задержку с каждой попыткой, а не отправляйте повторно подряд. |
| RequestId / ID запроса | Идентификатор отдельного запроса, используемый для поиска конкретной записи при диагностике. |
Ошибка валидации параметров 400 | Запрос не был принят; обычно расходы за задачу генерации не возникают. |
Эта страница была полезной? 