---
title: "Parancssori kliens (CLI) | FotóAI fejlesztői dokumentáció"
description: "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."
canonical: https://fotoai.hu/dokumentacio/cli
source: https://fotoai.hu/dokumentacio/cli.md
---

#### Dokumentáció: CLI

Fejlesztői dokumentáció

# 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](https://fotoai.hu/dokumentacio/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](https://fotoai.hu/dokumentacio/mcp). 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](https://fotoai.hu/dokumentacio/mcp/eszkozok)[Következő → · Partner REST API (v1)](https://fotoai.hu/dokumentacio/api)