Parancssori kliens (CLI)

Az npx fotoai-cli parancssori kliens: bejelentkezés böngészőben vagy API-kulccsal, képek, videók, hang, feladatok és a könyvtár a terminálból.

Telepítés

A CLI az npm fotoai csomagja (MIT-licenc, Node.js 18 vagy újabb, függőség nélkül). Telepítés nélkül is fut:

Terminál

npx fotoai-cli --help

Ha gyakran használod, telepítsd globálisan:

Terminál

npm i -g fotoai-cli
fotoai --version

Bejelentkezés

A fotoai login megnyitja a böngészőt, te a fotoai.hu-n jóváhagyod a hozzáférést, és a CLI megkapja a tokent – kulcsot nem kell másolnod. A háttérben OAuth 2.1 fut PKCE-vel és helyi visszahívással (http://127.0.0.1:<véletlen port>/callback); a CLI a tokent magától frissíti.

Terminál

fotoai login
fotoai whoami

Szerveren, CI-ban vagy böngésző nélküli gépen használj API-kulcsot:

Terminál

fotoai login --api-key fai_live_…
# vagy csak környezeti változóval, belépés nélkül:
export FOTOAI_API_KEY=fai_live_…

fotoai login --no-browser: nem nyit böngészőt, csak kiírja a jóváhagyó címet (például SSH-n át, ha a porttovábbítás megoldott).
A tokent vagy kulcsot a ~/.config/fotoai/config.json fájl tárolja, csak a te felhasználód számára olvashatóan (0600). fotoai logout törli.
--api-url vagy FOTOAI_API_URL: másik szerver (alapból https://fotoai.hu).
A CLI a Pro csomag része, bármelyik belépési móddal.

Generálás

Minden generáló parancs először árajánlatot kér, és kiírja az árat kreditben. Terminálban megerősítést vár; a --yes ezt kihagyja (szkriptből, terminál nélkül kötelező), a --dry-run csak az árat mutatja. Képnél a CLI alapból megvárja az eredményt; a videó percekig készül, ezért ott --wait vagy --out nélkül a feladat azonosítójával tér vissza. A CLI a jóváhagyott ajánlatot felső korlátként küldi tovább, így a generálás nem lehet drágább annál, amit láttál.

Kép

fotoai image "portré egy napfényes kávézóban" -a 3:4 --ref ./szelfi.jpg --out ./kepek
fotoai image "hegyi túra naplementében" --character <karakter-id> -n 2 --wait
fotoai image "…" --style <stílus-id> --dry-run

Videó és hang

fotoai video "lassú séta a parton" --start ./kep.png --out ./videok
fotoai speech "Szia, ez a FotóAI." --voice <hang-id> --out ./hang

A generáló parancsok kapcsolói

Kapcsoló	Jelentés
`-m, --model <id>`	Modell (fotoai models). Alapból a stílus vagy a kategória alapmodellje.
`-a, --aspect <arány>`	Képarány, például 1:1, 3:4, 16:9.
`-r, --resolution <felbontás>`	Felbontás, ha a modell ismeri (például 2K, 1080p).
`-n, --batch <db>`	Hány kép készüljön egy feladatban (kép).
`-d, --duration <mp>`	Hossz másodpercben (videó); az ár ezzel arányos.
`--ref <fájl\|id>`	Referenciakép (kép); ismételhető. Helyi fájlt előbb feltölt.
`--start / --end <fájl\|id>`	Kezdő- és zárókép (videó).
`--voice <id>`	Hang (felolvasás).
`-s, --style <id>`	Stílus vagy fotócsomag (fotoai styles).
`-c, --character <id\|név>`	Mentett karakter képei referenciaként (fotoai characters).
`--param kulcs=érték`	Bármely modellparaméter; ismételhető (fotoai models show <id>).
`--wait · --no-wait`	Megvárja az eredményt (terminálban folyamatjelzővel) – képnél ez az alap –, vagy azonnal visszaadja a feladat azonosítóját.
`-o, --out <mappa>`	Letölti az eredményt; magában foglalja a --wait-et.
`--timeout <mp>`	Ennyi idő után feladja a várakozást (a feladat fut tovább).
`--dry-run`	Csak árajánlat, nem generál.
`-y, --yes`	Nem kér megerősítést az ár után (terminálon kívül kötelező).

Minden parancs

Parancs	Mit csinál
`fotoai login`	Belépés böngészőben (OAuth). --api-key fai_live_… vagy --api-key-stdin kulccsal, --no-browser: csak kiírja a címet.
`fotoai logout`	Kilépés: törli a tárolt tokent vagy kulcsot, és visszavonja a böngészős belépést.
`fotoai whoami`	Ki vagy, melyik szerverhez és hogyan csatlakozol.
`fotoai me · fotoai credits`	Kreditegyenleg és csomag.
`fotoai models [image\|video\|audio]`	Modellek: azonosító, név, „-tól” ár kreditben, csomag, használható-e.
`fotoai models show <id>`	Egy modell paraméterei, értékei és ártáblája.
`fotoai styles [--packs]`	Stílusok és fotócsomagok (azonosító, csomagméret, alapmodell).
`fotoai characters`	A mentett karaktereid (referenciakép-készletek).
`fotoai image "<prompt>"`	Képgenerálás (lásd lent).
`fotoai video "<prompt>"`	Videógenerálás; --start / --end kezdő- és zárókép (fájl vagy asset-azonosító).
`fotoai speech "<szöveg>" · fotoai tts`	Szövegfelolvasás; --voice <id>.
`fotoai quote image\|video\|speech …`	Csak árajánlat, ugyanazokkal a kapcsolókkal – nem költ kreditet.
`fotoai jobs list [--limit n]`	A legutóbbi feladataid (minden forrásból).
`fotoai jobs get <id> [--wait] [--out dir]`	Egy feladat állapota; várakozás és letöltés.
`fotoai jobs cancel <id>`	Még el nem indult feladat lemondása; a lefoglalt kredit felszabadul.
`fotoai assets list [--kind image\|video\|audio] [--limit n]`	A könyvtárad.
`fotoai assets get <id>`	Egy fájl adatai.
`fotoai assets download <id>… [--out dir]`	Fájlok letöltése.
`fotoai upload <fájl>…`	Feltöltés referenciának → asset-azonosító.
`fotoai skill install [--project] · fotoai skill show [--path]`	Az AI-ügynök skill telepítése (--project: csak ebbe a projektbe) vagy kiírása.
`fotoai mcp tools · fotoai mcp call <tool> '<json>'`	Nyers MCP-hívás, ha valamire nincs külön parancs.

Minden parancsnak van súgója: fotoai <parancs> --help. Általános kapcsolók: --json, --yes, --quiet, --api-url.

A CLI a partner REST API-t használja (árajánlat quote_id-val, idempotens generálás, feltöltés, feladatok), a könyvtárhoz és a karakterekhez ugyanazzal a tokennel a /api/assets és /api/reference-sets végpontokat, a fotoai mcp … parancsokhoz pedig az MCP-szervert. Az általa indított feladatok a könyvtárban „cli” forrással jelennek meg.

JSON mód és kilépési kódok

A --json géppel olvasható kimenetet ad; ha a kimenet nem terminál (csővezeték, szkript), ez az alapértelmezés. A folyamatjelző és a kérdések ilyenkor a standard hibakimenetre mennek, vagy elmaradnak.

Terminál

fotoai image "piros alma" --yes --wait --json | jq -r '.outputs[0].url'
fotoai credits --json | jq .balance_credits

Kód	Jelentés
0	Sikerült.
1	Általános hiba.
2	Hibás parancs vagy kapcsoló.
3	Nincs belépve, vagy a token/kulcs érvénytelen.
4	Nincs elég kredit, vagy a modell magasabb csomagot kér (402).
5	Sebességkorlát (429) – várj, és próbáld újra.
6	A feladat hibával zárult (failed / rejected).

AI-ügynök skill

A csomagban van egy SKILL.md: egy Agent Skill, amely megtanítja az AI-ügynököknek (Claude Code és társai) a FotóAI használatát. Egy paranccsal telepíthető a ~/.claude/skills/fotoai/ mappába:

Terminál

npx fotoai-cli skill install
# vagy nézd meg előbb:
npx fotoai-cli skill show

beállítás: npx fotoai-cli login vagy API-kulcs;
modellválasztás ár és minőség szerint (fotoai models);
árajánlat minden költés előtt, és soha nem generál ciklusban a felhasználó jóváhagyása nélkül;
--wait --out a letöltéshez, --json a kimenet feldolgozásához;
referenciaképek, karakterek és stílusok használata;
hibaelhárítás: belépés, kredit, csomag, sebességkorlát.

Kérj árat, mielőtt költesz

Az ügynök ugyanúgy költ kreditet, mint te. A skill ezért mindig --dry-run-nal vagy fotoai quote-tal kezd, és csak a jóváhagyásod után indítja a generálást.

← ElőzőMCP-eszközök referenciája Következő →Partner REST API (v1)