Перейти к основному содержанию
POST
/
api
/
v2
/
generate
Создание генерации
curl --request POST \
  --url https://api.example.com/api/v2/generate \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "params": {}
}
'
{
  "id": 123,
  "status": "<string>",
  "result_text": {},
  "result_url": {},
  "tokens_spent": 123,
  "processing_ms": 123
}

​
Обзор

POST /api/v2/generate — это один эндпоинт для всей AI-генерации: текст, изображения, видео, аудио, TTS, музыка. Слаг модели определяет что генерируется и какие params принимаются.
​
Authorization
string
обязательно
Authorization: Bearer nb_ВАШ_API_КЛЮЧ
​
model
string
обязательно
Слаг модели. См. Каталог моделей для всех доступных слагов.
​
prompt
string
обязательно
Промпт или входной текст. Для текстовых моделей: сообщение пользователя. Для изображений/видео: описание.
​
params
object
по умолчанию:"{}"
Параметры конкретной модели. Примеры ниже по категориям.

​
Генерация текста

{
  "model": "claude-sonnet-4.5",
  "prompt": "Напиши описание товара для беспроводных наушников",
  "params": {
    "system_prompt": "Ты профессиональный копирайтер.",
    "temperature": 0.7,
    "max_tokens": 500
  }
}

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

{
  "model": "flux-1.1-pro",
  "prompt": "Портрет CEO в современном офисе, профессиональная фотография",
  "params": {
    "negative_prompt": "размытость, водяной знак, текст",
    "size": "1024x1024",
    "format": "webp",
    "seed": 42
  }
}
Общие параметры изображений (params):
ПараметрТипОписание
sizestringНапример: 1024x1024, 1024x1792, 768x1344
formatstringwebp (по умолчанию), png, jpeg
qualitystringstandard или hd (DALL-E 3, GPT Image)
negative_promptstringЧто исключить (Flux, SD модели)
seedintegerДля воспроизводимых результатов
aspect_ratiostringНапример: 16:9, 9:16 (Midjourney)

​
Генерация видео

{
  "model": "kling-v2.1-pro",
  "prompt": "Облёт дрона над футуристическим городом ночью, кинематографично",
  "params": {
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}
Видео-генерации возвращают status: "pending". Опрашивайте GET /api/v2/generate/{id} для получения результата.

​
Ответ

​
id
integer
ID генерации. Используйте для опроса: GET /api/v2/generate/{id}
​
status
string
completed | pending | failed
​
result_text
string | null
Текстовый результат (для LLM, STT).
​
result_url
string | null
URL файла (для изображений, видео, аудио, TTS).
​
tokens_spent
integer
Потраченные токены NeuralBox. Ноль при ошибке.
​
processing_ms
integer
Время обработки в миллисекундах.

​
Пример ответа — текст

{
  "id": 18473,
  "status": "completed",
  "model_slug": "claude-sonnet-4.5",
  "result_text": "Представляем наши Premium беспроводные наушники...",
  "result_url": null,
  "error": null,
  "tokens_spent": 3,
  "processing_ms": 2104,
  "result_metadata": null
}

​
Пример ответа — изображение

{
  "id": 18491,
  "status": "completed",
  "model_slug": "flux-1.1-pro",
  "result_text": null,
  "result_url": "https://storage.neuralbox.top/generations/18491.webp",
  "tokens_spent": 8,
  "processing_ms": 6840,
  "result_metadata": { "width": 1024, "height": 1024 }
}

​
Пример ответа — ожидание (видео)

{
  "id": 18502,
  "status": "pending",
  "model_slug": "kling-v2.1-pro",
  "result_url": null,
  "tokens_spent": 0,
  "processing_ms": null
}