LakásAI CLI

AI-képek lakásokról, házakról és kertekről — a parancssorból, vagy az AI-ügynöködből.

A LakásAI magyar nyelvű alkalmazás, amely ingatlanfotókat alakít át: rendet rak a képen, bebútoroz egy üres szobát, stílust vált, rendbe teszi a kertet, javítja a fényeket. Ez a parancssori felülete. Ugyanazt a nyilvános API-t használja, mint a webes alkalmazás, és ugyanabból a kreditegyenlegből dolgozik: amit itt készítesz, ott is megjelenik a galériádban.

A parancsok, a kapcsolók és a súgó szándékosan angol nyelvű: a parancssort fejlesztők és ügynökök használják. A hibaüzenetek magyarul jönnek a szerverről, mert azokat egy embernek kell elolvasnia.

Használat AI-ügynökkel

A csomagban megtalálod a kifejezetten ügynököknek szánt parancsreferenciát, a SKILL.md fájlt. Telepítés után mutasd meg az ügynöknek, és további magyarázat nélkül tudja használni az egész CLI-t.

Telepítés

npm install -g lakasai
# vagy egyszeri futtatásra
npx lakasai --help

A csomag és a parancs neve is lakasai. Node 20 vagy újabb kell hozzá. Futásidejű függősége nincs.

Bejelentkezés

1. lehetőség: eszközfolyamat (ajánlott)

lakasai auth:login     # kiír egy kódot és megnyit egy böngészőt
lakasai auth:status    # ellenőrzi, hogy még érvényes-e
lakasai auth:logout    # törli a tárolt kulcsot

A terminál kiír egy nyolc karakteres kódot, a böngésző pedig megnyitja a jóváhagyó oldalt. Ott látod, mit kér ez a gép, és kiveheted, amit nem akarsz megadni — például a képgenerálást, ami kreditet költ.

A kulcs a ~/.lakasai/credentials.json fájlba kerül, 0600 jogosultsággal, egy 0700 jogosultságú könyvtárban. A fájl elkülönül a beállításoktól, így a logout a titkot törli, a konfigurációdat békén hagyja.

2. lehetőség: API-kulcs — szerverhez, CI-hez, konténerhez:

export LAKASAI_API_KEY=a_kulcsod    # Beállítások → API-kulcsok, a webes felületen

A környezeti változó erősebb a tárolt kulcsnál. Ez szándékos: a környezet az, amit böngésző nélkül be tudsz állítani, és nem írhatja felül némán az, ami véletlenül benne maradt egy image home könyvtárában.

Parancsok

Fiók

lakasai credits                  # egyenleg, csomag, korlátok
lakasai models                   # modellkatalógus árakkal; ✗ = nincs a csomagodban
lakasai styles                   # stílus-, művelet- és helyiség-azonosítók
lakasai styles --kind style      # csak a stílusok
lakasai styles --kind op         # csak a műveletek
lakasai styles --kind room       # csak a helyiségek

Képek készítése

# Szövegből
lakasai generate -p "világos skandináv nappali, nagy ablakokkal" -n 2 -o ./kesz

# Meglévő fotó módosítása
lakasai edit konyha.jpg -p "cseréld le a konyhabútort tölgyfa frontosra" -o ./kesz

# Átstílusozás — a szoba geometriája marad, a berendezés változik
lakasai style nappali.jpg -s scandinavian --room nappali -o ./kesz

# Hirdetési műveletek, +-szal kombinálva (egy menet, egy kép, egyszeri levonás)
lakasai op nappali.jpg --op declutter+relight -o ./kesz

# Felnagyítás
lakasai upscale homlokzat.jpg --size print -o ./kesz

# GPT Image 2.5: a minőség választható, és az ár vele változik
lakasai generate -p "…" -m gpt-image-flare -q low -o ./kesz

A --quality (low, medium, high, xhigh, max) csak a GPT Image 2.5 modelleken (gpt-image-flare, gpt-image-sunburst) értelmezett; más modellnél a szerver hibával utasítja el, nem hagyja figyelmen kívül. A pontos árat minőségenként és méretszintenként a lakasai models írja ki.

A + egyetlen kéréssé fűzi a műveleteket: egy kép készül, egyszer vonunk le — a modell árát. Három külön op három kép és három levonás, és mindegyik részben felülírja az előzőt.

A -n / --count több képet kér egy kérésben. A szerver 1–8-at fogad el, majd a modell saját maximumára vágja (több modellnél 4 vagy 6; felnagyításnál 1). A lakasai models listájában a max N oszlop — és a JSON maxImages mezője — mondja meg, mennyit kapsz ténylegesen.

A fájl helyett megadhatsz egy korábbi feltöltés azonosítóját is. Ez a gyakorlatban azt jelenti, hogy ugyanazt a konyhát négyféle stílusban egyszer kell feltölteni:

ID=$(lakasai upload konyha.jpg | jq -r .id)
for s in scandinavian modern industrial japandi; do
  lakasai style "$ID" -s "$s" -o "./kesz/$s"
done

Feltöltés, előzmények és letöltés

lakasai upload konyha.jpg             # feltöltés, kiírja az id-t
lakasai images                        # előzmények
lakasai images --status completed
lakasai image <id> --wait -o ./kesz   # megvárja a futó feladatot
lakasai download <kép-id> -o kesz.jpg

Beállítások

lakasai config:get
lakasai config:set outDir ./kesz      # alapértelmezett kimeneti könyvtár
lakasai config:set apiUrl https://lakasai.hu/api

Metaadatok

Az AI-modellek minden generált képbe beleírnak egy rejtett „Content Credentials" (C2PA) bejegyzést arról, hogy a kép mesterséges intelligenciával készült. Nagyjából 100 KB, és minden képnézegetőben látszik.

lakasai generate -p "..." --no-metadata     # metaadat nélkül készül és tárolódik
lakasai download <id> --no-metadata         # letöltéskor tisztítjuk meg
lakasai download <id> --metadata            # a fiókbeállítás felülírása

Ha egyik kapcsolót sem adod meg, a fiókod beállítása dönt (Beállítások → Képek metaadatai). A tisztítás veszteségmentes: a metaadat-blokkokat kivágjuk, a képpontokat nem tömörítjük újra.

Kimenet

stdout   a parancs eredménye JSON-ban, és semmi más
stderr   emberi szöveg: haladás, figyelmeztetés, hiba

Hiba esetén a kilépési kód nem nulla. Így egy szkript egyszerre tud jq-val dolgozni és set -e-re támaszkodni.

Kreditek és idempotencia

A pontos árat a lakasai models mondja meg — a táblázat élő, egy itt leírt szám elavulna. A terhelés a feladat indításakor történik; ha a generálás elbukik, a szerver visszatéríti.

A CLI minden generáláshoz küld egy Idempotency-Key-t, és ugyanazzal a kulccsal újrapróbálja a kérést, ha a válasz elvész (a kapcsolat megszakad), vagy a szerver 409 operation_in_progress választ ad — legfeljebb három kísérlet, rövid várakozással. Egy 4xx, ami valódi válasz (402, 403, 400), nem ismétlődik. A parancs újbóli futtatása új kulcs és új levonás: két azonos lakasai generate két szándék, két kép. Ha közvetlenül az API-t hívod, küldj te is egyet, és ugyanazt használd, ha ugyanazt a szándékot ismétled.

Környezeti változók

| Változó | Mire jó | | --- | --- | | LAKASAI_API_KEY | Kulcs, a tárolt hitelesítő adatok helyett | | LAKASAI_API_URL | API-alapcím. Alapértelmezés: https://lakasai.hu/api | | LAKASAI_CLIENT_NAME | Ez a név jelenik meg a jóváhagyó oldalon |

A --api kapcsoló csak az adott hívásra írja felül az API-alapcímet.

Dokumentáció

Parancssor: https://lakasai.hu/dokumentacio/cli

HTTP API: https://lakasai.hu/dokumentacio