Перейти к основному содержанию
POST
/
api
/
v2
/
generate
AI-инструменты
curl --request POST \
  --url https://api.example.com/api/v2/generate
Все AI-инструменты доступны на тарифе Starter (подписка не нужна). Стоимость: 1–3 токена.

​
Доступные инструменты

SlugНазваниеТокеныОписание
upscaleUpscale ESRGAN1Увеличение изображения в 2×/4×
face-swapFace Swap1Замена лица между двумя изображениями
remove-bgRemove BG1Удаление фона с изображения
style-transferStyle Transfer1Перенос художественного стиля
colorizeColorize1Раскраска чёрно-белых фото
inpaintInPaint Edit3Редактирование выбранной области
text-ocrText OCR1Извлечение текста из изображений

​
Формат запроса

Инструменты используют тот же эндпоинт POST /api/v2/generate. Передайте слаг инструмента в model, URL изображения в params: 
curl -X POST https://neuralbox.top/api/v2/generate \
  -H "Authorization: Bearer nb_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "remove-bg",
    "prompt": "remove background",
    "params": {
      "image_url": "https://example.com/photo.jpg"
    }
  }'

​
Примеры

import requests

# Удаление фона
res = requests.post(
    "https://neuralbox.top/api/v2/generate",
    headers={"Authorization": "Bearer nb_ВАШ_КЛЮЧ"},
    json={
        "model": "remove-bg",
        "prompt": "remove background",
        "params": {"image_url": "https://example.com/portrait.jpg"}
    }
)
print(res.json()["result_url"])

# Апскейл 4x
res = requests.post(
    "https://neuralbox.top/api/v2/generate",
    headers={"Authorization": "Bearer nb_ВАШ_КЛЮЧ"},
    json={
        "model": "upscale",
        "prompt": "upscale",
        "params": {"image_url": "https://example.com/photo.jpg", "scale": 4}
    }
)
print(res.json()["result_url"])

# OCR — извлечь текст
res = requests.post(
    "https://neuralbox.top/api/v2/generate",
    headers={"Authorization": "Bearer nb_ВАШ_КЛЮЧ"},
    json={
        "model": "text-ocr",
        "prompt": "extract text",
        "params": {"image_url": "https://example.com/document.jpg"}
    }
)
print(res.json()["result_text"])

​
Ответ

{
  "id": 18530,
  "status": "completed",
  "model_slug": "remove-bg",
  "result_url": "https://storage.neuralbox.top/generations/18530.png",
  "tokens_spent": 1,
  "processing_ms": 2140
}
Все инструменты обрабатываются синхронно — опрос статуса не нужен, в ответе всегда status: completed.