Сводка частых вопросов

На этой странице по темам собраны частые вопросы по использованию платформы. Для каждого пункта указаны причина и конкретные дальнейшие шаги; более подробная диагностика на уровне интерфейсов — в разделе Коды ошибок и диагностика, вопросы по рабочей среде создания — в разделе Частые вопросы по веб-созданию.

Аккаунт и вход

Почему при открытии Creation снова требуется вход?

LocoPal Ai — единственный источник идентичности. Creation зависит от междоменного Cookie сеанса, выдаваемого locopalai.com, — если этот Cookie недействителен или отсутствует, подплатформа перенаправляет на единую страницу входа.

Сначала проверьте: открыт ли LocoPal Ai и выполнен ли вход. Если вход выполнен, а подплатформа по-прежнему показывает отсутствие входа, обновите страницу подплатформы; если это не помогает, выйдите из LocoPal Ai и войдите снова.

Нужно ли отдельно входить в Creation на другом компьютере?

Нет. Достаточно один раз войти в LocoPal Ai — Creation автоматически получает состояние входа.

Влияет ли смена пароля или выход из аккаунта на другие платформы?

Да. Выход из аккаунта, переключение аккаунта и смена пароля одновременно завершают сеанс Creation — это нормальное поведение единой системы сеансов.

Ключи API

Можно ли одним Key вызывать все интерфейсы?

Да. Интерфейсы моделей, изображений, видео, аудио и материалов используют один и тот же Key; создавать отдельные Key для разных интерфейсов не нужно.

Почему этот Key не видит определённую модель?

Видимость моделей определяется группой вызовов, к которой относится Key. Проверьте, выполнив с этим Key запрос GET /v1/models: если в возвращённом data нет этой модели, значит, она не входит в права этой группы.

Что означает "data": [] в ответе?

Это означает, что в группе текущего Key нет ни одной доступной модели. Сначала проверьте правильность настройки группы; если остаются вопросы, обратитесь в поддержку платформы и укажите имя Key (не предоставляйте полный Key).

Что делать при утечке Key?

Немедленно отключите этот Key в разделе «Ключи API» консоли (а не ждите его естественного истечения), затем создайте новый Key для бизнеса и замените конфигурацию. Отключение не влияет на материалы, задачи и историю аккаунта.

Почему нельзя хранить Key во фронтенд-коде?

Любое содержимое браузера или мобильного установочного пакета может быть извлечено. Key должен храниться в серверных переменных окружения или сервисе управления секретами, а вызовы платформы должен выполнять ваш бэкенд.

Модели и вызовы

Что указывать в model запроса?

Указывайте data[].id из ответа GET /v1/models без изменений. Не используйте отображаемое название со страницы каталога моделей.

Сообщение «Модель временно недоступна» или «Нет доступных каналов»

Это означает, что в текущий период невозможно маршрутизировать запрос к этой модели, и не указывает на проблему с Key. Сначала обновите список моделей или переключитесь на аналогичную модель; если модель остаётся недоступной, обратитесь в поддержку платформы и укажите ID запроса.

Текстовый вызов возвращает пустой content, а finish_reason равен length

Модель рассуждений может израсходовать весь max_tokens на процесс рассуждения (completion_tokens_details.reasoning_tokens). Увеличьте лимит вывода или переключитесь на модель без рассуждений и повторите попытку.

Интерфейс изображений возвращает unknown_parameter

Некоторые модели изображений (например, серия GPT Image) не принимают поле response_format. Уберите это поле и повторите попытку. Поддержка size, quality и response_format определяется текущей моделью.

Возвращённый URL изображения не открывается

Интерфейс изображений может возвращать временный адрес — как можно скорее сохраните файл в собственное хранилище. Изображения, которые нужны для долгосрочного повторного использования, следует сначала добавить в библиотеку материалов, а затем ссылаться на них через asset://<asset_id>.

Видеозадачи

Почему видео — асинхронная задача?

Генерация видео занимает много времени, поэтому платформа использует схему «создание задачи → запрос результата». Интерфейс создания возвращает ID задачи, после чего интерфейс запроса опрашивает прогресс и результат.

Если после отправки локальное ожидание истекло по таймауту, нужно ли создавать задачу заново?

Нет. После получения ID задачи даже при локальном таймауте можно только продолжать запрашивать исходную задачу. Повторное создание приведёт к дублирующимся задачам и повторным расходам.

В ответе создания нет progress — это ошибка?

Нет. В ответе создания следует полагаться только на id / task_id, status, model и created_at; поля вроде object и progress могут появиться только при первом запросе, и их нельзя считать обязательными для успешного создания.

Статус failed — как узнать причину?

Прочитайте error.code и error.message в том же ответе. Для окончательного сбоя видеозадачи обычно используется video_generation_failed; error.message уже содержит очищенную читаемую причину — не пытайтесь разбирать JSON внутри неё.

Будет ли повторное списание при запросе результата?

Нет. Запрос только читает статус и не создаёт расходов. Новые расходы возникают только при повторном создании задачи — именно поэтому не следует отправлять задачу повторно.

Материалы и разрешение на использование образа

Нужно ли загружать материалы отдельно для каждой модели?

Нет. Материал нужно добавить в библиотеку только один раз — в единую библиотеку материалов платформы; все модели, поддерживающие ссылки на материалы, используют один и тот же материал, ID материала остаётся неизменным, а при смене модели достаточно изменить поле model в запросе.

Когда материал становится доступен для использования?

Материал стабильно доступен только после того, как data.asset.status станет Active. Если отображается «Загрузка» или «Обработка», сохраните материал и дождитесь завершения; не отправляйте повторно один и тот же неудачный элемент подряд.

Какой адрес изображения указывать при отправке материала?

Используйте адрес http(s), который можно напрямую скачать из публичной сети, или, в пределах ограничений интерфейса, передавайте data_url. Не передавайте локальный путь к файлу браузера в качестве параметра интерфейса.

Можно ли заменить материал реального человека обычным изображением?

Нет. Материал реального человека должен быть собран и авторизован самим человеком с помощью сканирования QR-кода на телефоне. Процесс в консоли: «Управление библиотекой материалов → Создать группу → Библиотека материалов с реальными людьми → Создать QR-код → человек сканирует код → сканирование завершено, начать синхронизацию».

Что произойдёт при переключении на модель, не поддерживающую материалы реальных людей?

Материалы реальных людей работают только в моделях, явно поддерживающих эту возможность. При переключении на неподдерживаемую модель платформа не автоматически преобразует их в обычное референсное изображение; используйте виртуальные материалы или вернитесь к поддерживающей модели.

Влияют ли материалы на другие модели?

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

Биллинг и баланс

Списываются ли средства сразу при отправке видеозадачи?

Нет. Асинхронные задачи рассчитываются при завершении; успешная отправка только принимает задачу и не списывает средства заранее. Перед отправкой платформа проверяет, покрывают ли баланс или квота Key текущую предварительную оценку; при недостатке сразу возвращается читаемое сообщение, и задача не создаётся.

Списываются ли средства при ошибке валидации параметров (400)?

Обычно нет. 400 означает, что запрос не был принят, и, как правило, расходы за задачу генерации не возникают.

Является ли цена на карточке цены окончательным списанием?

Нет. Карточка цены предназначена для оценки; фактическое списание определяется фактическим использованием запроса, группой и записями биллинга на сервере. Подробнее см. в разделе Биллинг и счета.

Кажется, что списание некорректно — как проверить?

Найдите конкретную запись по ID задачи, идентификатору запроса, ID модели и временному диапазону, затем сверьте с детализацией счёта. Не предоставляйте полный ключ.

Платформа и инструменты создания

Каково соотношение двух платформ?

LocoPal Ai — ядро, предоставляющее аккаунт, биллинг, модели, материалы и записи задач; Creation — клиент, подключающийся к нему. Подробнее см. в разделе Обзор платформ.

Можно ли использовать через API материалы, созданные в Creation?

Да. Оба используют одну и ту же библиотеку материалов, и ID материалов совпадают.

Приводит ли обновление страницы к повторной генерации или повторному списанию?

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

Всё ещё не решено

При обращении в поддержку укажите: время возникновения, название модели, ID задачи или ID запроса, HTTP-статус (при вызове интерфейса), очищенное от конфиденциальных данных сообщение об ошибке, а также тип запроса (текст / изображение / видео / аудио).

Не отправляйте: API keys, полный заголовок Authorization, Cookie входа, реальные данные изображения человека или полный подписанный адрес материала. Соответствующие требования см. в разделе Коды ошибок и диагностика.