От задачи
до интеграции.

Начните самостоятельно

API-кабинет открывается после регистрации и подтверждения email. Выберите ключ и окружение: Sandbox проверяет интеграцию без модели, рабочий API использует доступные аккаунту модели. Для помощи с нестандартной интеграцией можно обратиться в поддержку.

Node.js: проверка ключа · Python: чтение каталога · Подключение MCP · Контроль расходов

Единые цены

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

Схема интеграции

1. Создайте рабочий ключ в API-кабинете и проверьте доступ аккаунта. Храните секрет только на сервере.
2. Запросите цену через /images/quotes либо /videos/quotes. Расчёт не запускает генерацию.
3. Проверьте цену и срок расчёта. После согласия подтвердите через /images/generations либо /videos/generations с quoteId, confirm: true и сохранённым idempotencyKey.
4. HTTP 202 означает очередь. Опросите /jobs/ID для фото либо /videos/jobs/ID для видео.
5. Скачайте результат по приватному result.url с тем же ключом. Проверяйте expiresAt; результаты хранятся 7 дней.

Base URL: https://api.prelusion.ru/api/developer/v1. Зарегистрируйтесь, подтвердите email и создайте ключ в API-кабинете. Доступ к конкретной модели зависит от условий аккаунта. Примеры расчёта сами не запускают генерации.

curl https://prelusion.ru/api/developer/v1/images/quotes \
  -H "Authorization: Bearer $PRELUSION_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "prelusion/nano-banana-2-1",
  "prompt": "Стеклянная ваза на сером фоне",
  "quality": "1K",
  "aspectRatio": "1:1"
}'

curl https://prelusion.ru/api/developer/v1/videos/quotes \
  -H "Authorization: Bearer $PRELUSION_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "prelusion/seedance-2-0",
  "prompt": "Камера плавно приближается к стеклянной вазе",
  "duration": 5,
  "resolution": "480p",
  "aspectRatio": "16:9"
}'

curl https://prelusion.ru/api/developer/v1/videos/quotes \
  -H "Authorization: Bearer $PRELUSION_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "prelusion/seedance-2-5",
  "prompt": "Камера плавно приближается к стеклянной вазе",
  "duration": 5,
  "resolution": "480p",
  "aspectRatio": "16:9"
}'

Ошибки и безопасные повторы

Повтор подтверждения выполняется с теми же quoteId и idempotencyKey. Если статус reconciling, ждите сверки и не создавайте новую задачу.

Текстовый API: GPT, Claude и Gemini

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

1. Вызовите POST /api/developer/v1/text/quotes с моделью, сообщениями и пределом ответа. В ответе rub — максимальный резерв, а не фактическое списание.
2. Подтвердите резерв через POST /api/developer/v1/text/generations: quoteId, confirm: true и уникальный idempotencyKey. Ответ 202 означает очередь.
3. Проверяйте GET /api/developer/v1/text/jobs/{id}. Получите текст по приватной ссылке result.url с тем же ключом API.

{
  "model": "prelusion/gpt-5-6-sol",
  "messages": [
    {
      "role": "user",
      "content": "Придумай три названия для приложения"
    }
  ],
  "maxOutputTokens": 2048
}

Списание рассчитывается отдельно по фактическим входным и выходным токенам, по версии тарифа из расчёта. Неиспользованный резерв освобождается. finishReason: length означает, что ответ обрезан пределом длины; это не полный ответ. Состояние reconciling требует проверки: не создавайте повторный платный запрос с новым ключом. Потоковый режим и вызовы инструментов в этом обработчике пока не поддерживаются.

import hashlib, hmac, time

def verify_webhook(secret, signature, raw_body):
    fields = dict(part.split("=", 1) for part in signature.split(","))
    timestamp = fields["t"]
    if abs(time.time() - int(timestamp)) > 300:
        raise ValueError("Expired signature")
    signed = timestamp.encode("ascii") + b"." + raw_body
    expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(expected, fields["v1"]):
        raise ValueError("Invalid signature")
    # Parse JSON only after verification. Deduplicate event ID in your database.
    return True

Баланс по API

GET /api/developer/v1/balance с заголовком Authorization: Bearer $PRELUSION_API_KEY возвращает currency, balanceRub, reservedRub, availableRub и checkedAt. Запрос бесплатный: не запускает модель и не создаёт резерв. Используйте действующий платный ключ своего аккаунта, не Sandbox-ключ. Проверка остаётся доступна при остановке новых генераций.

Для нового запроса ориентируйтесь на availableRub, а не на весь баланс. Ответ — снимок на указанное время, не гарантия будущего резерва: параллельные задачи могут изменить сумму. Не опрашивайте чаще раза в минуту; при 429 соблюдайте Retry-After.

Баланс и оплата

API-кредиты — единицы баланса, не токены нейросети. Изображение оплачивается за результат, видео — за секунду; текст оплачивается раздельно за входные и выходные токены. Резерв не равен списанию. Заявка не создаёт аккаунт, ключ, платёж или счёт. Перед платным запросом проверьте условия аккаунта, доступный баланс и сумму расчёта.