Vývojáři · API v1

Jedno API.
Každý model.

Obrázky, video, zvuk a 3D za jedním API. Volejte ho z Node, Pythonu nebo curlu, případně ho skriptujte z terminálu pomocí CLI Genlaxy, vše placené ze stejného zůstatku jako studio.

Získat API klíč →Rychlý start
$npm i -g genlaxy
Modely
730
Endpointy
9
Minimální dobití
3 €
01 · Příklady

Stejné volání, jakýkoli výstup

Změňte ID modelu a přepnete se mezi obrázkem, videem a řečí. Pole se řídí modelem.

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()));
Ukázkový renderluma/uni-v1/text-to-image
02 · Rychlý start

První render ve třech krocích

  1. 01Vytvořte API klíčPřihlaste se e-mailem, otevřete Nastavení, API klíče a vytvořte klíč. Dobijte od 3 € v části Platby.export GENLAXY_API_KEY="gl_live_..."
  2. 02Nainstalujte CLIJeden příkaz, Node.js 18.3 nebo novější. Nebo to přeskočte a volejte API libovolným HTTP klientem.npm i -g genlaxy
  3. 03Vytvořte první renderVyberte ID modelu z katalogu a pošlete prompt. Přidejte --dry-run a uvidíte cenu, aniž byste cokoli utratili.genlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLINové

Renderování z terminálu

Spouštějte libovolný model ze shellu, úlohy CI nebo programátorského agenta. Každý render se ocení před spuštěním a čerpá ze stejného zůstatku.

Skripty a CIKaždé pole modelu je přepínač; místní soubor se nahraje za vás.
JSON na stdoutJeden dokument JSON na spuštění, průběh a chyby na stderr, při selhání nenulový návratový kód.
Programátorští agentiSoubor dovednosti naučí vašeho agenta nejdřív zkontrolovat cenu a omezit ji.
Úplný průvodce CLI →
PříkazCo dělá
genlaxy loginJednou vložte svůj API klíč; ověří se a uloží
genlaxy whoamiNázev klíče a váš zůstatek
genlaxy models --type videoKaždý video model s výchozí cenou
genlaxy run <model> -hPole modelu načtená živě: typ, výchozí hodnota, povolené hodnoty
genlaxy run <model> -p "<prompt>" -o ./out/Vyrenderovat a uložit výsledek do složky
genlaxy run <model> -p "..." --dry-runPřesná cena, aniž byste cokoli utratili
genlaxy run <model> -p "..." --max-price 0.50Odmítnout spuštění, pokud je cena vyšší
genlaxy run <model> -p "..." --json -o ./out/Jeden výsledek v JSON, připravený pro další krok
genlaxy skill installNaučte svého programátorského agenta používat CLI
04 · Základy API

Připraveno pro produkci

Ověření

Token Bearer v hlavičce Authorization. Klíče vytvářejte v Nastavení a kterýkoli z nich můžete kdykoli zrušit.

Authorization: Bearer gl_live_...

Rendery na pozadí

Spuštění renderu odpoví okamžitě se stavem queued. Dotazujte se na render, dokud se nezdaří, neuspěje nebo nebude vrácen.

{ "status": "queued" }

Cena předem

Zjistěte přesnou cenu svých vstupů, aniž byste cokoli spouštěli. Každá částka je v eurocentech.

POST /api/v1/api/catalog/quote

Bezpečné opakování

Pošlete hlavičku Idempotency-Key a opakovaný požadavek nikdy neúčtuje dvakrát.

Idempotency-Key: render-042

Limity

Každý klíč má limit za minutu a volitelný denní strop. Po překročení limitu API odpoví 429.

429 Too Many Requests

Chyby a vrácení peněz

Chyby v JSON s kódem a zprávou. Nezdařený render se automaticky vrátí na váš zůstatek.

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

Endpointy

Základní URL https://genlaxy.ai/api/v1/api/catalog

Úplná reference API →
GET/meVáš klíč a zůstatek
GET/modelsVšechny modely
GET/models/detail?id=MODEL_IDJeden model a jeho pole
POST/quoteCena pro přesné vstupy
POST/generationsSpustit render
GET/generationsVaše poslední rendery
GET/generations/IDStav jednoho renderu
GET/generations/ID/contentVýsledný soubor
DELETE/generations/IDSmazat render

Dobijte 3 € a začněte ještě dnes

API, CLI i studio sdílejí jeden zůstatek. Nezdařené rendery se vracejí.

Získat API klíč →Zobrazit ceník