Desarrolladores · API v1

Una API.
Todos los modelos.

Imágenes, video, audio y 3D detrás de una sola API. Llámala desde Node, Python o curl, o automatízala desde la terminal con la CLI de Genlaxy, todo pagado con el mismo saldo que el estudio.

Obtener una clave de API →Inicio rápido
$npm i -g @genlaxy/cli
Modelos
641
Endpoints
9
Recarga mínima
5 €
01 · Ejemplos

La misma llamada, cualquier resultado

Cambia el ID del modelo para pasar de imagen a video o voz. Los campos dependen del modelo.

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()));
Render de ejemploluma/uni-v1/text-to-image
02 · Inicio rápido

Tu primer render en tres pasos

  1. 01Crea una clave de APIInicia sesión con tu email, abre Ajustes, Claves de API y crea una clave. Recarga desde 5 € en Facturación.export GENLAXY_API_KEY="gl_live_..."
  2. 02Instala la CLIUn solo comando, Node.js 18.3 o superior. O sáltatela y llama a la API con cualquier cliente HTTP.npm i -g @genlaxy/cli
  3. 03Haz tu primer renderElige un ID de modelo del catálogo y envía un prompt. Añade --dry-run para ver el precio sin gastar nada.genlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLINuevo

Renderiza desde la terminal

Ejecuta cualquier modelo desde una shell, un job de CI o un agente de código. Cada render se cotiza antes de empezar y se cobra del mismo saldo.

Scripts y CICada campo de un modelo es un flag; un archivo local se sube por ti.
JSON en stdoutUn documento JSON por ejecución, progreso y errores en stderr, código de salida distinto de cero si falla.
Agentes de códigoUn archivo de skill enseña a tu agente a consultar primero el precio y a limitarlo.
Guía completa de la CLI →
ComandoQué hace
genlaxy loginPega tu clave de API una vez; se verifica y se guarda
genlaxy whoamiEl nombre de la clave y tu saldo
genlaxy models --type videoTodos los modelos de video con su precio inicial
genlaxy run <model> -hLos campos de un modelo, en vivo: tipo, valor por defecto, valores permitidos
genlaxy run <model> -p "<prompt>" -o ./out/Renderiza y guarda el resultado en una carpeta
genlaxy run <model> -p "..." --dry-runEl precio exacto, sin gastar nada
genlaxy run <model> -p "..." --max-price 0.50No ejecuta si el precio es mayor
genlaxy run <model> -p "..." --json -o ./out/Un resultado JSON, listo para el siguiente paso
genlaxy skill installEnseña a tu agente de código a usar la CLI
04 · Lo esencial de la API

Lista para producción

Autenticación

Un token Bearer en el encabezado Authorization. Crea claves en Ajustes y revoca cualquiera en cualquier momento.

Authorization: Bearer gl_live_...

Renders en segundo plano

Iniciar un render responde al instante con el estado queued. Consulta el render hasta que termine con éxito, falle o se reembolse.

{ "status": "queued" }

Primero el precio

Pide el precio exacto de tus parámetros sin iniciar nada. Todos los importes están en céntimos de euro.

POST /api/v1/api/catalog/quote

Reintentos seguros

Envía un encabezado Idempotency-Key y una petición repetida nunca cobra dos veces.

Idempotency-Key: render-042

Límites

Cada clave tiene un límite por minuto y un tope diario opcional. Al superarlo, la API responde 429.

429 Too Many Requests

Errores y reembolsos

Errores JSON con un código y un mensaje. Un render fallido se reembolsa a tu saldo automáticamente.

{ "status": "refunded" }
05 · Referencia

Endpoints

URL base https://genlaxy.ai/api/v1/api/catalog

Referencia completa de la API →
GET/meTu clave y tu saldo
GET/modelsTodos los modelos
GET/models/detail?id=MODEL_IDUn modelo y sus campos
POST/quotePrecio para entradas exactas
POST/generationsIniciar una generación
GET/generationsTus generaciones recientes
GET/generations/IDEstado de una generación
GET/generations/ID/contentEl archivo resultante
DELETE/generations/IDEliminar una generación

Recarga 5 € y lanza hoy

La API, la CLI y el estudio comparten un mismo saldo. Los renders fallidos se reembolsan.

Obtener una clave de API →Ver precios