PRELUSION API на Node.js: проверка ключа без генерации

Подготовьте ключ на сервере

Зарегистрируйтесь, подтвердите email и создайте ключ API в кабинете. Установите Node.js 22 или новее. Передайте ключ через переменную окружения PRELUSION_API_KEY. Не вставляйте его в HTML, frontend-код, адрес страницы и репозиторий.

Sandbox и рабочий каталог

Ключ pl_test_ обращается к /api/developer-sandbox/v1/models и возвращает тестовую модель Echo. Ключ pl_live_ использует /api/developer/v1/models. Echo проверяет интеграцию, но не качество ответа нейросети. Чтение рабочего каталога не является генерацией.

Как прочитать результат

Поле data содержит публичные ID моделей. Используйте ID из текущего ответа, а не закупочное название или ID из сторонней документации. Успешный GET подтверждает чтение каталога, но не качество модели и не доступность каждого платного режима.

Пример: JavaScript

Только GET к PRELUSION. Код не выполняется на этой странице и не содержит настоящего ключа.

// Node.js 22+. Только чтение каталога — без генерации и оплаты.
const key = process.env.PRELUSION_API_KEY || '';
if (!/^pl_(test|live)_[A-Za-z0-9_-]{43}$/.test(key)) {
  throw new Error('Укажите ключ PRELUSION_API_KEY в окружении сервера');
}
const sandbox = key.startsWith('pl_test_');
const base = sandbox ? '/api/developer-sandbox/v1' : '/api/developer/v1';
const response = await fetch('https://api.prelusion.ru' + base + '/models', {
  headers: { Authorization: 'Bearer ' + key },
  redirect: 'error',
  signal: AbortSignal.timeout(15000)
});
if (!response.ok) throw new Error('Каталог недоступен: HTTP ' + response.status);
const body = await response.json();
if (!Array.isArray(body.data)) throw new Error('Неожиданный формат каталога');
console.log({ sandbox, models: body.data.map(m => ({ id: m.id, name: m.name || m.id })) });

Как начать

1. Зарегистрируйтесь и подтвердите email.
2. Откройте API-кабинет, проверьте условия доступа и создайте ключ проекта.
3. Проверьте подключение без генерации, выберите модель и получите расчёт.
4. Для платной генерации проверьте баланс и отдельно подтвердите стоимость.

Регистрация и проверка подключения не требуют платного запуска. Доступ и лимиты конкретной модели проверяются в кабинете. Документация и примеры запросов.

Цены и ограничения

Цены доступны после регистрации. Текст учитывается по входным и выходным токенам, изображение — по выбранной конфигурации, видео — по длительности и тарифу секунды. Нулевой тариф бесплатной модели может измениться; новый платный запуск требует нового расчёта и подтверждения. Действуют условия API и оферта.

Названия моделей принадлежат их разработчикам. Стандартный API рассчитан на запросы без персональных данных, секретов и внутренних документов. Безопасность интеграции.

Практика интеграции