API Genlaxy: každý model z vašeho kódu

1 · Ověření

Vytvořte klíč v Nastavení, sekce API klíče. Posílejte ho s každým požadavkem jako token Bearer. Klíče začínají na gl_live_ a fungují jen na Genlaxy; uchovávejte je na serveru, nikdy v prohlížeči ani v aplikaci.

curl

curl https://genlaxy.ai/api/v1/api/catalog/me \
  -H 'Authorization: Bearer gl_live_...'

Nebo použijte CLI

Dáváte přednost terminálu nebo programátorskému agentovi? Balíček npm genlaxy toto API obaluje: nainstalujte ho, přihlaste se svým klíčem a spusťte libovolný model podle jeho id.

curl

npm i -g genlaxy

Dokumentace CLI →

2 · Výběr modelu

Vyberte model a uvidíte hotový požadavek sestavený z jeho vlastních polí. Povinná pole jsou vyplněná; každé volitelné nastavení používá výchozí hodnotu modelu.

Vybraný modelbytedance/seedream-v5.0-lite/edit-sequential

Stránka modelu →

Pole
Název	Typ	Povinné	Výchozí
prompt	text	ano	-
images	url (image)	ano	-
size	text	ne	-
max_images	number	ne	1
output_format	jpeg \| png	ne	jpeg

3 · Spuštění renderu

Jedno volání spočítá cenu vašich přesných vstupů a strhne ji ze zůstatku. Odpověď přijde okamžitě se stavem queued; render běží na pozadí. Pošlete hlavičku Idempotency-Key, aby opakovaný požadavek nikdy neúčtoval dvakrát.

curl

curl -X POST https://genlaxy.ai/api/v1/api/catalog/generations \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "modelId": "bytedance/seedream-v5.0-lite/edit-sequential",
  "inputs": {
    "prompt": "a lighthouse on a cliff at dusk, soft light",
    "images": [
      "https://example.com/input.png"
    ]
  }
}'

Nejprve zkontrolujte cenu (volitelné)

Stejné vstupy, jen oceněné bez spuštění čehokoli. Odpověď je v centech.

curl

curl -X POST https://genlaxy.ai/api/v1/api/catalog/quote \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"modelId":"bytedance/seedream-v5.0-lite/edit-sequential","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light","images":["https://example.com/input.png"]}}'

4 · Dotazování a stažení

Každých pár sekund se dotazujte na render, dokud stav není succeeded, failed nebo refunded. Po úspěchu stáhněte soubor z contentUrl stejným klíčem. Textový model vrací odpověď místo toho v textOutput.

curl

curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID \
  -H 'Authorization: Bearer gl_live_...'

curl

curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID/content \
  -H 'Authorization: Bearer gl_live_...' \
  -o result.png

Endpointy

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

GET	/me	Váš klíč a zůstatek
GET	/models	Všechny modely
GET	/models/detail?id=MODEL_ID	Jeden model a jeho pole
POST	/quote	Cena pro přesné vstupy
POST	/generations	Spustit render
GET	/generations	Vaše poslední rendery
GET	/generations/ID	Stav jednoho renderu
GET	/generations/ID/content	Výsledný soubor
DELETE	/generations/ID	Smazat render

Ceny a zůstatek

Rendery přes API čerpají ze stejného zůstatku jako studio a stojí stejně. Každá částka v API je v eurocentech: costCents je to, co render stál, balanceCents to, co zbývá.

Chyby a limity

Chyby se vracejí jako JSON s kódem a zprávou. 401: chybějící, nesprávný nebo zrušený klíč. 400: neplatné pole (podrobnosti ho uvádějí). 402: nedostatečný zůstatek. 409 API_KEY_DAILY_CAP: byl dosažen denní limit klíče. 429: příliš mnoho požadavků, zpomalte. Nezdařený render se vrací automaticky. 403 s HTML stránkou: požadavek byl zastaven dříve, než dorazil k API, obvykle kvůli hlavičce User-Agent. Výchozí hodnota Python-urllib je blokována, proto pošlete vlastní, například User-Agent: my-app/1.0.