DESENTRA ДЛЯ ВАШЕГО РАБОЧЕГО ПРОЦЕССА

Ваше приложение. Наши AI-модели.

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

Создать API-ключ Примеры запросов

Создайте ключ

Войдите в аккаунт, создайте ключ ниже и сразу сохраните его. Полностью он показывается только один раз.

Проверьте доступ

Передавайте ключ в заголовке Authorization. Начните с проверки аккаунта — она не запускает генерацию.

Получите результат

Отправьте запрос на генерацию и проверяйте статус по taskId. Стоимость списывается с баланса Desentra.

ДОСТУП К МОДЕЛЯМ

Ваш API-ключ

Доступ к интеграциям

Ваш ключ Desentra

API / MCP

Один ключ для API и MCP-подключений по этому ключу. Генерации используют общий баланс вашего аккаунта. OAuth-подключения используют отдельные токены.

Загружаю ключ…

REST API

От первого запроса до результата

Базовый адрес: https://desentraai.ru. В защищённых запросах передавайте Authorization: Bearer YOUR_DESENTRA_API_KEY.

1. Проверьте ключ без генерации

Этот запрос возвращает аккаунт и баланс. Поле authenticated: true подтверждает, что ключ принят.

GET /api/auth/session

curl 'https://desentraai.ru/api/auth/session' \
  --header 'Authorization: Bearer YOUR_DESENTRA_API_KEY'

2. Посмотрите модели и параметры

Открытый каталог показывает поддерживаемые модели, режимы и форматы. Проверяйте его перед отправкой запроса.

GET /api/capabilities

curl 'https://desentraai.ru/api/capabilities'

3. Пример генерации изображения и проверки статуса

POST запускает платную генерацию. Выберите доступную модель и параметры из каталога, проверьте баланс и стоимость перед запуском.

POST /api/image/generate

curl --request POST 'https://desentraai.ru/api/image/generate' \
  --header 'Authorization: Bearer YOUR_DESENTRA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "kieai",
  "model": "nano-banana-2",
  "prompt": "Белый кроссовок на тёплом песке, рекламный кадр",
  "resolution": "2K",
  "aspectRatio": "1:1",
  "outputFormat": "png",
  "chatKey": "fox:nanobanana:api-demo"
}'

Из ответа возьмите taskId или id. Подставьте его вместо TASK_ID, сохранив тот же chatKey. Проверяйте статус с интервалом несколько секунд до succeeded или failed.

GET /api/image/status

curl 'https://desentraai.ru/api/image/status?provider=kieai&id=TASK_ID&chatKey=fox:nanobanana:api-demo' \
  --header 'Authorization: Bearer YOUR_DESENTRA_API_KEY'

Image/api/image/generate/api/image/status

Video/api/video/generate/api/video/status

Audio/api/audio/generate/api/audio/status

Market/api/market/generate/api/market/status

Понятные ответы на ошибки

401

Проверьте ключ и заголовок Authorization. Отозванный ключ больше не работает.

402

Недостаточно кредитов. Пополните баланс на сайте и повторите запрос.

400

Проверьте параметры, модель и референсы по каталогу /api/capabilities.

429

Слишком много запросов. Подождите и уменьшите частоту обращений.