Разработчикам · API v1

Один API.
Все модели.

Изображения, видео, аудио и 3D за одним API, оплата с того же баланса, что и в студии. Ключ создаётся в Настройках. CLI скоро появится.

Получить ключ APIБыстрый старт

СкороCLI и SDK скоро появятся. REST API ниже работает уже сегодня.

Моделей
672
Эндпоинтов
9
Мин. пополнение
3 €
01 · Примеры

Один вызов, любой результат

Смените ID модели, чтобы перейти от изображения к видео или речи. Поля зависят от модели.

1# 1. Generate an image2curl -X POST https://femimg.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $FEMIMG_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://femimg.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $FEMIMG_API_KEY"17 18# 3. Download the file19curl https://femimg.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $FEMIMG_API_KEY" \21  -o result.jpeg
landing.dev.outputTitleluma/uni-v1/text-to-image
02 · Быстрый старт

Первый рендер за три шага

  1. 01Создайте ключ APIВ Настройках > Ключи API назовите ключ и скопируйте его один раз. Пополните баланс от 3 € в разделе Оплата.export FEMIMG_API_KEY="YOUR_API_KEY"
  2. 02Запустите рендерОтправьте ID модели и входные данные. Сразу придёт генерация со статусом queued.POST /api/v1/api/catalog/generations
  3. 03Опрашивайте и скачивайтеОпрашивайте генерацию, пока статус не станет succeeded, затем скачайте файл.GET /api/v1/api/catalog/generations/ID/content
03 · CLIСкоро

Рендер из терминала

Консольный инструмент для скриптов, CI и агентов-программистов уже в пути: те же ключи и тот же баланс, что и у API. А пока все вызовы на этой странице работают через curl.

Скрипты и CIРендер из любой оболочки, задачи или cron.
Вывод JSONОдин JSON-документ за запуск, готовый для следующего шага.
Агенты-программистыАгент сначала узнаёт цену и ограничивает расходы.
04 · Основы API

Готово к продакшену

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

Bearer-токен в заголовке Authorization. Ключи создаются в Настройках.

Authorization: Bearer YOUR_API_KEY

Фоновые рендеры

Запуск рендера сразу отвечает статусом queued. Опрашивайте, пока он не станет succeeded, failed или refunded.

{ "status": "queued" }

Сначала цена

Узнайте точную цену для ваших данных, ничего не запуская. Все суммы в центах евро.

POST /api/v1/api/catalog/quote

Безопасные повторы

Передайте заголовок Idempotency-Key, и повторный запрос никогда не спишет деньги дважды.

Idempotency-Key: render-042

Лимиты

У каждого ключа есть лимит запросов в минуту. При превышении вернётся ошибка 429.

429 Too Many Requests

Ошибки и возвраты

Ошибки в JSON с кодом и сообщением. Неудавшийся рендер автоматически возвращается на баланс.

{ "status": "refunded" }
05 · Справочник

Эндпоинты

Базовый URL https://femimg.com/api/v1

GET/api/catalog/meИмя и лимит ключа, ваш баланс
GET/api/catalog/modelsКаталог моделей с ценами
GET/api/catalog/models/detail?id=MODEL_IDОдна модель со всеми полями
POST/api/catalog/quoteТочная цена для набора данных
POST/api/catalog/generationsЗапустить рендер любой моделью
GET/api/catalog/generationsВаши последние генерации
GET/api/catalog/generations/IDСтатус, стоимость и результат генерации
GET/api/catalog/generations/ID/contentСкачать готовый файл
DELETE/api/catalog/generations/IDУдалить генерацию

Пополните на 3 € и запускайте сегодня

API и студия используют один баланс. Неудавшийся рендер возвращается.

Получить ключ APIСмотреть цены