REST API · v1

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

falapi.io даёт единый API к десяткам нейросетей генерации картинок и видео (FLUX, Kling, Veo и др.). Один ключ, один эндпоинт, оплата кредитами. Мы держим очереди, ретраи и балансировку моделей — вы получаете готовый результат.

Базовый URL: https://falapi.io/v1 · Формат: JSON · Промпт можно писать на русском — он автоматически переводится в английский для модели.

Авторизация

Все запросы требуют ваш API-ключ в заголовке Authorization. Ключ создаётся в личном кабинете → раздел API и показывается один раз.

Authorization: Bearer falapi_ВАШ_КЛЮЧ

Список моделей GET /v1/models

Возвращает доступные модели с ценой в кредитах.

Баланс GET /v1/balance

Текущий остаток кредитов: { "credits": 97 }

Генерация POST /v1/generate

Основной метод. Принимает модель и промпт, возвращает ссылки на готовые медиа. Запрос синхронный — ответ приходит, когда генерация завершена (картинки — секунды, видео — до нескольких минут).

Пример ответа

{
  "generation_id": 128,
  "credits_spent": 1,
  "credits_left": 97,
  "media": [
    { "type": "image", "url": "https://v3b.fal.media/files/.../out.jpg" }
  ]
}

Параметры запроса

Поле	Тип	Описание
`model` обяз.	string	ID модели из `/v1/models` (напр. `flux-dev`, `kling`).
`prompt` обяз.	string	Описание. Любой язык — русский переводится автоматически.
`size`	string	Картинки: `square` · `landscape` · `portrait`. По умолчанию square.
`numImages`	int	Картинки: 1–4. Кредиты умножаются на количество.
`duration`	int	Видео: длительность в секундах. Кредиты = цена/сек × длительность.
`imageUrl`	string	Для моделей-редакторов (Kontext) и image-to-video: ссылка на исходное изображение.

Каталог моделей и цены

Модель	Тип	ID	Кредиты

Коды ошибок

HTTP	error	Причина
401	`missing_api_key` / `invalid_api_key`	Нет или неверный ключ.
400	`unknown_model`	Неизвестный ID модели.
400	`empty_prompt`	Пустой промпт.
400	`image_required`	Модель требует `imageUrl`.
402	`insufficient_credits`	Недостаточно кредитов — пополните баланс.
502	`generation_failed`	Ошибка модели. Кредиты автоматически возвращаются.

При любой неудачной генерации кредиты возвращаются на баланс автоматически — вы платите только за результат.