Быстрый старт

1. Получите API-ключ

Доступ к API включён в тарифы VIP и Elite.

Откройте elumenta.ru/web → Профиль → API-ключи
Нажмите Создать ключ, дайте ему название
Скопируйте ключ — он начинается с nb_

Храните ключ в безопасном месте. Он даёт полный доступ к вашему балансу токенов. Никогда не раскрывайте его в клиентском коде.

2. Единый эндпоинт генерации

Все генерации проходят через один эндпоинт: POST /api/v2/generate

curl -X POST https://elumenta.ru/api/v2/generate \
  -H "Authorization: Bearer nb_ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "prompt": "Объясни квантовые вычисления простыми словами"
  }'

import requests

response = requests.post(
    "https://elumenta.ru/api/v2/generate",
    headers={"Authorization": "Bearer nb_ВАШ_API_КЛЮЧ"},
    json={
        "model": "gpt-5",
        "prompt": "Объясни квантовые вычисления простыми словами"
    }
)

data = response.json()
print(data["result_text"])
print(f"Потрачено токенов: {data['tokens_spent']}")

const response = await fetch("https://elumenta.ru/api/v2/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer nb_ВАШ_API_КЛЮЧ",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "gpt-5",
    prompt: "Объясни квантовые вычисления простыми словами"
  })
});

const data = await response.json();
console.log(data.result_text);

3. Структура ответа

{
  "id": 18473,
  "status": "completed",
  "model_slug": "gpt-5",
  "result_text": "Квантовые вычисления используют кубиты...",
  "result_url": null,
  "tokens_spent": 2,
  "processing_ms": 1842
}

Поле	Описание
`result_text`	Текстовый результат (для LLM)
`result_url`	URL файла (для изображений, видео, аудио)
`tokens_spent`	Потраченные токены
`status`	`completed` / `pending` / `failed`
`id`	Числовой ID — для опроса асинхронных задач

4. Генерация изображения

curl -X POST https://elumenta.ru/api/v2/generate \
  -H "Authorization: Bearer nb_ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "Футуристический город на закате, киберпанк стиль",
    "params": {
      "size": "1024x1024",
      "format": "webp"
    }
  }'

5. Проверка баланса

curl https://elumenta.ru/api/v2/balance \
  -H "Authorization: Bearer nb_ВАШ_API_КЛЮЧ"

{
  "token_balance": 283,
  "plan": "vip",
  "plan_expires_at": "2026-04-08T00:00:00Z"
}

6. Опрос асинхронных результатов

Для видео status будет pending. Опрашивайте GET /api/v2/generate/{id}:

import time, requests

def ожидать_результат(gen_id: int, api_key: str) -> dict:
    headers = {"Authorization": f"Bearer {api_key}"}
    while True:
        data = requests.get(
            f"https://elumenta.ru/api/v2/generate/{gen_id}",
            headers=headers
        ).json()
        if data["status"] in ("completed", "failed"):
            return data
        time.sleep(5)

Следующие шаги

Полный справочник API

Все параметры и опции моделей

Стриминг

Потоковая генерация текста через SSE

Каталог моделей

Все 52 слага с ценами

Обработка ошибок

Повторные попытки, backoff, коды ошибок

Начало работы

Концепции

Руководства

Генерация (создание)

Генерация (результаты)

Модели

Пользователь

API-ключи

Ассистенты

Платежи

Расписания

Авторизация

Ресурсы

Быстрый старт

1. Получите API-ключ

2. Единый эндпоинт генерации

3. Структура ответа

4. Генерация изображения

5. Проверка баланса

6. Опрос асинхронных результатов

Следующие шаги

Полный справочник API

Стриминг

Каталог моделей

Обработка ошибок

​1. Получите API-ключ

​2. Единый эндпоинт генерации

​3. Структура ответа

​4. Генерация изображения

​5. Проверка баланса

​6. Опрос асинхронных результатов

​Следующие шаги

Полный справочник API

Стриминг

Каталог моделей

Обработка ошибок

1. Получите API-ключ

2. Единый эндпоинт генерации

3. Структура ответа

4. Генерация изображения

5. Проверка баланса

6. Опрос асинхронных результатов

Следующие шаги