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

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

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

CLI Airogenia уже в пути. Эта страница показывает, как она будет работать; пока пользуйтесь API.

$npm i -g @airogenia/cli
Моделей
672
Эндпоинтов
9
Минимальное пополнение
3 €
01 · Примеры

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

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

1import { writeFile } from "node:fs/promises";2 3const API = "https://airogenia.com/api/v1/api/catalog";4const auth = { Authorization: `Bearer ${process.env.AIROGENIA_API_KEY}` };5 6// 1. Generate an image7const res = await fetch(`${API}/generations`, {8  method: "POST",9  headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },10  body: JSON.stringify({11    modelId: "luma/uni-v1/text-to-image",12    inputs: { prompt: "Neon city street after rain, cinematic night", size: "16:9" },13  }),14});15let { generation } = await res.json();16 17// 2. Wait for the result18while (generation.status === "queued" || generation.status === "generating") {19  await new Promise((r) => setTimeout(r, 3000));20  ({ generation } = await (await fetch(`${API}/generations/${generation.id}`, { headers: auth })).json());21}22 23// 3. Save the file24const file = await fetch(`${API}/generations/${generation.id}/content`, { headers: auth });25await writeFile("result.jpeg", Buffer.from(await file.arrayBuffer()));
Пример рендераluma/uni-v1/text-to-image
02 · Быстрый старт

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

  1. 01Создайте API-ключВойдите по email, откройте Настройки, API-ключи и создайте ключ. Пополнение от 3 € в разделе Оплата.export AIROGENIA_API_KEY="ai_live_..."
  2. 02CLI скоро появитсяКонсольный инструмент ещё не опубликован. Пока всё работает в студии.npm i -g @airogenia/cli
  3. 03Сделайте первый рендерВыберите ID модели в каталоге и отправьте промпт. Добавьте --dry-run, чтобы узнать цену, ничего не потратив.airogenia run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLIСкоро

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

Запускайте любую модель из shell, CI или кодинг-агента. Цена каждого рендера известна до старта и списывается с того же баланса.

Скрипты и CIКаждое поле модели доступно как флаг; локальный файл загружается автоматически.
JSON в stdoutОдин JSON-документ на запуск, прогресс и ошибки в stderr, ненулевой код выхода при сбое.
Кодинг-агентыФайл навыка учит агента сначала проверять цену и ограничивать её.
Полное руководство по CLI →
КомандаЧто делает
airogenia loginВставьте API-ключ один раз: он проверяется и сохраняется
airogenia whoamiИмя ключа и ваш баланс
airogenia models --type videoВсе видеомодели с начальной ценой
airogenia run <model> -hПоля модели, загруженные в реальном времени: тип, значение по умолчанию, допустимые значения
airogenia run <model> -p "<prompt>" -o ./out/Рендер с сохранением результата в папку
airogenia run <model> -p "..." --dry-runТочная цена, ничего не тратится
airogenia run <model> -p "..." --max-price 0.50Отказ от запуска, если цена выше
airogenia run <model> -p "..." --json -o ./out/Один результат в JSON, готовый для следующего шага
airogenia skill installНаучите кодинг-агента пользоваться CLI
04 · Основы API

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

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

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

Authorization: Bearer ai_live_...

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

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

{ "status": "queued" }

Сначала цена

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

POST /api/v1/api/catalog/quote

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

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

Idempotency-Key: render-042

Лимиты

У каждого ключа есть лимит в минуту и необязательный дневной потолок. Сверх лимита API отвечает 429.

429 Too Many Requests

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

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

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

Эндпоинты

Базовый URLhttps://airogenia.com/api/v1/api/catalog

Полный справочник API →
GET/meВаш ключ и баланс
GET/modelsВсе модели
GET/models/detail?id=MODEL_IDОдна модель и её поля
POST/quoteЦена для конкретных входных данных
POST/generationsЗапустить генерацию
GET/generationsВаши последние генерации
GET/generations/IDСтатус одной генерации
GET/generations/ID/contentФайл результата
DELETE/generations/IDУдалить генерацию

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

Создайте API-ключ в настройках и вызывайте любую модель. CLI скоро появится. Неудачные рендеры возвращаются.