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

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

Изображения, видео, аудио и 3D через один API. Вызывайте его из Node, Python или curl либо автоматизируйте из терминала с Genlaxy CLI. Оплата с того же баланса, что и в студии.

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

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

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

1import { writeFile } from "node:fs/promises";2 3const API = "https://genlaxy.ai/api/v1/api/catalog";4const auth = { Authorization: `Bearer ${process.env.GENLAXY_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-ключи и создайте ключ. Пополнение от 5 € в разделе Оплата.export GENLAXY_API_KEY="gl_live_..."
  2. 02Установите CLIОдна команда, Node.js 18.3 или новее. Или обойдитесь без него и вызывайте API любым HTTP-клиентом.npm i -g @genlaxy/cli
  3. 03Сделайте первый рендерВыберите ID модели в каталоге и отправьте промпт. Добавьте --dry-run, чтобы узнать цену, ничего не потратив.genlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLIНовое

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

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

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

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

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

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

Authorization: Bearer gl_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 · Справочник

Эндпоинты

Базовый URL https://genlaxy.ai/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Удалить генерацию

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

API, CLI и студия работают с одним балансом. Неудачные рендеры возвращаются.