API-документация
falapi.io даёт единый API к озвучке текста живым голосом (13 голосов, естественный русский) и к десяткам нейросетей генерации картинок и видео (FLUX, Kling, Veo и др.). Один ключ, один эндпоинт, оплата кредитами. Мы держим очереди, ретраи и балансировку моделей — вы получаете готовый результат.
https://falapi.io/v1 · Формат: JSON · Для картинок и видео промпт можно писать на русском — он автопереводится в английский. Для озвучки текст не переводится — произносится дословно на любом языке.Авторизация
Все запросы требуют ваш API-ключ в заголовке Authorization. Ключ создаётся в личном кабинете → раздел API и показывается один раз.
Authorization: Bearer falapi_ВАШ_КЛЮЧ
Список моделей GET /v1/models
Возвращает доступные модели с ценой в кредитах.
Баланс GET /v1/balance
Текущий остаток кредитов: { "credits": 97 }
Озвучка текста POST /v1/generate
Синтез речи живым голосом. Модель tts-eleven, поле prompt — текст для озвучки, voice — идентификатор голоса (см. Голоса). Возвращает ссылку на mp3. Цена — 2 кредита за 1000 символов.
Пример ответа
{
"generation_id": 268,
"credits_spent": 2,
"credits_left": 97,
"media": [
{ "type": "audio", "url": "https://falapi.io/media/tts/6ce20ae1.mp3" }
]
}
Картинки и видео POST /v1/generate
Тот же метод. Принимает модель и промпт, возвращает ссылки на готовые медиа. Запрос синхронный — ответ приходит, когда генерация завершена (картинки — секунды, видео — до нескольких минут).
Пример ответа
{
"generation_id": 128,
"credits_spent": 1,
"credits_left": 97,
"media": [
{ "type": "image", "url": "https://.../out.jpg" }
]
}
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
model обяз. | string | ID модели из /v1/models (напр. tts-eleven, flux-dev, kling). |
prompt обяз. | string | Озвучка — текст для произнесения (дословно, любой язык). Картинки/видео — описание (русский переводится автоматически). |
voice | string | Озвучка: идентификатор голоса из списка Голоса. По умолчанию — Алиса (русский). |
size | string | Картинки: square · landscape · portrait. По умолчанию square. |
numImages | int | Картинки: 1–4. Кредиты умножаются на количество. |
duration | int | Видео: длительность в секундах. Кредиты = цена/сек × длительность. |
imageUrl | string | Для моделей-редакторов (Kontext) и image-to-video: ссылка на исходное изображение. |
Каталог моделей и цены
| Модель | Тип | ID | Кредиты |
|---|
Голоса озвучки
Значения поля voice для модели tts-eleven. Полный актуальный список всегда отдаёт GET /v1/models (поле voices у модели озвучки).
| Голос | voice (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 | Ошибка модели. Кредиты автоматически возвращаются. |