api документация

REST API для генерации изображений, видео и аудио. Оптимизировано для AI-агентов с минимальным расходом токенов.

быстрый старт

curl -X POST https://api.neuroartist.ru/api/v1/generate \
  -H "Authorization: Bearer na_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fal-ai/flux/schnell",
    "input": { "prompt": "горы на закате" },
    "sync": true
  }'

аутентификация

передавайте API ключ в заголовке Authorization:

Authorization: Bearer na_live_xxxxxxxxxxxxx

ключи начинаются с na_live_ для production и na_test_ для тестового окружения.

endpoints

POST /api/v1/generate

request

{
  "model": "fal-ai/flux/schnell",
  "input": {
    "prompt": "A cat astronaut",
    "image_size": "landscape_16_9",
    "num_images": 1
  },
  "sync": true
}

response

{
  "id": "req_abc123",
  "status": "completed",
  "model": "fal-ai/flux/schnell",
  "output": {
    "images": [{ "url": "https://cdn.neuroartist.ru/..." }]
  },
  "processing_time_ms": 2340,
  "cost_rub": 1.35
}

POST /api/v1/upload

загрузка файлов для img2img, video и других моделей.

multipart/form-data

curl -X POST https://api.neuroartist.ru/api/v1/upload \
  -H "Authorization: Bearer na_live_..." \
  -F "file=@image.png"

response

{
  "file_id": "uuid",
  "url": "https://cdn.neuroartist.ru/...",
  "provider_url": "https://...",
  "expires_at": "2026-03-04T12:00:00Z"
}

используйте provider_url в параметрах генерации (image_url и т.д.)

коды ошибок

usage tiers

тир повышается автоматически по мере накопления платежей.