Desenvolvedores · API v1

Uma API.
Todos os modelos.

Imagens, vídeo, áudio e 3D por trás de uma única API. Chame-a de Node, Python ou curl, ou automatize pelo terminal com a CLI da Genlaxy, tudo pago com o mesmo saldo do estúdio.

Obter uma chave de API →Início rápido
$npm i -g @genlaxy/cli
Modelos
641
Endpoints
9
Recarga mínima
€ 5
01 · Exemplos

A mesma chamada, qualquer resultado

Troque o ID do modelo para alternar entre imagem, vídeo e voz. Os campos seguem o 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 exemploluma/uni-v1/text-to-image
02 · Início rápido

Seu primeiro render em três passos

  1. 01Crie uma chave de APIEntre com seu email, abra Configurações, Chaves de API e crie uma chave. Recarregue a partir de € 5 em Cobrança.export GENLAXY_API_KEY="gl_live_..."
  2. 02Instale a CLIUm único comando, Node.js 18.3 ou mais recente. Ou dispense a CLI e chame a API com qualquer cliente HTTP.npm i -g @genlaxy/cli
  3. 03Faça seu primeiro renderEscolha um ID de modelo no catálogo e envie um prompt. Adicione --dry-run para ver o preço sem gastar nada.genlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLINovo

Renderize pelo terminal

Execute qualquer modelo a partir de um shell, um job de CI ou um agente de código. Cada render tem o preço calculado antes de começar e é pago com o mesmo saldo.

Scripts e CICada campo de um modelo é uma flag; um arquivo local é enviado para você.
JSON no stdoutUm documento JSON por execução, progresso e erros no stderr, código de saída diferente de zero em caso de falha.
Agentes de códigoUm arquivo de skill ensina seu agente a verificar o preço primeiro e a limitá-lo.
Guia completo da CLI →
ComandoO que faz
genlaxy loginCole sua chave de API uma vez; ela é verificada e salva
genlaxy whoamiO nome da chave e o seu saldo
genlaxy models --type videoTodos os modelos de vídeo com o preço inicial
genlaxy run <model> -hOs campos de um modelo, ao vivo: tipo, padrão, valores permitidos
genlaxy run <model> -p "<prompt>" -o ./out/Renderiza e salva o resultado em uma pasta
genlaxy run <model> -p "..." --dry-runO preço exato, sem gastar nada
genlaxy run <model> -p "..." --max-price 0.50Não executa se o preço for maior
genlaxy run <model> -p "..." --json -o ./out/Um resultado em JSON, pronto para o próximo passo
genlaxy skill installEnsine seu agente de código a usar a CLI
04 · Essencial da API

Pronta para produção

Autenticação

Um token Bearer no cabeçalho Authorization. Crie chaves em Configurações e revogue qualquer uma a qualquer momento.

Authorization: Bearer gl_live_...

Renders em segundo plano

Iniciar um render responde na hora com o status queued. Consulte o render até que ele seja concluído, falhe ou seja reembolsado.

{ "status": "queued" }

Preço primeiro

Peça o preço exato dos seus parâmetros sem iniciar nada. Todos os valores estão em centavos de euro.

POST /api/v1/api/catalog/quote

Repetições seguras

Envie um cabeçalho Idempotency-Key e uma requisição repetida nunca cobra duas vezes.

Idempotency-Key: render-042

Limites

Cada chave tem um limite por minuto e um teto diário opcional. Acima do limite, a API responde 429.

429 Too Many Requests

Erros e reembolsos

Erros em JSON com um código e uma mensagem. Um render que falha é reembolsado no seu saldo automaticamente.

{ "status": "refunded" }
05 · Referência

Endpoints

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

Referência completa da API →
GET/meSua chave e seu saldo
GET/modelsTodos os modelos
GET/models/detail?id=MODEL_IDUm modelo e seus campos
POST/quotePreço para entradas exatas
POST/generationsIniciar uma geração
GET/generationsSuas gerações recentes
GET/generations/IDStatus de uma geração
GET/generations/ID/contentO arquivo de resultado
DELETE/generations/IDExcluir uma geração

Recarregue € 5 e lance hoje

A API, a CLI e o estúdio compartilham um único saldo. Renders com falha são reembolsados.

Obter uma chave de API →Ver preços