Dokumentáció: Áttekintés
Fejlesztői dokumentáció
Áttekintés és kezdés
A FotóAI fejlesztői felületei: MCP-szerver, parancssori kliens (CLI) és a partner REST API. API-kulcs vagy OAuth, és mikor melyik.
Három felület, egy kredit
A FotóAI modelljei a webes felületen kívül három módon érhetők el. Mindhárom ugyanazt az árazást, ugyanazokat a csomagkorlátokat és ugyanazt a kreditegyenleget használja, mint a web: nincs külön API-ár.
| Felület | Mire való | Cím |
|---|---|---|
| MCP-szerver | AI-asszisztensek (Claude Code, Cursor, VS Code, Codex, Claude Desktop) közvetlenül generálnak képet, videót és hangot. | https://fotoai.hu/api/mcp |
| CLI | Parancssor és szkriptek: árajánlat, generálás, várakozás, letöltés egy paranccsal. | npx fotoai-cli |
| REST API v1 | Partneralkalmazások (például a Posty) és saját integrációk – a verziózott, stabil szerződés. | https://fotoai.hu/api/v1 |
API-kulcs vagy OAuth
Két bejelentkezési mód van, és mindhárom felület mindkettőt elfogadja a Authorization: Bearer … fejlécben.
| Szempont | Személyes API-kulcs | OAuth 2.1 |
|---|---|---|
| Formátum | fai_live_… | fai_oat_… hozzáférési token (1 óra) + fai_ort_… frissítő token |
| Kinek | Neked, a saját gépeden: szkriptek, CI, Claude Code, Cursor. | Alkalmazásoknak, amelyek a te nevedben dolgoznak – és a CLI böngészős belépésének. |
| Honnan | Beállítások → API-kulcsok | Jóváhagyó képernyő a fotoai.hu-n; nem kell kulcsot másolnod. |
| Csomag | Pro (az MCP/API-hozzáférés a Pro része) | Partneralkalmazás (Posty): bármely csomag. A CLI és az MCP OAuth-tal is Pro. |
| Visszavonás | A kulcs törlése az API-kulcsok oldalon. | Kapcsolt alkalmazások → Leválasztás. |
- Saját szkript, szerver, CI, headless gép: API-kulcs (
FOTOAI_API_KEY). - A CLI a saját gépeden:
npx fotoai-cli login– megnyitja a böngészőt, jóváhagyod, és kész; a kulcsot nem kell sehová bemásolnod. - Harmadik fél alkalmazása (Posty és más partnerek): OAuth 2.1 – a felhasználó a FotóAI-on hagyja jóvá a hozzáférést.
API-kulcs létrehozása
- Jelentkezz be, és nyisd meg a Beállítások → API-kulcsok oldalt (vagy az MCP/CLI oldalt).
- Adj nevet a kulcsnak (például „Claude Code”), és hozd létre.
- A teljes kulcsot csak egyszer mutatjuk: mentsd el egy jelszókezelőbe. Ha elveszett, töröld és készíts újat.
A kulcs a pénztárcád
Egy API-kulccsal kreditet lehet költeni. Ne tedd verziókezelőbe, ne oszd meg, és CI-ban titkos változóként add át. A kulcs a Pro csomaghoz kötött: ha a csomag lejár, a kulcs azonnal megszűnik működni.
Gyorsindítás
Claude Code-ba egy paranccsal kerül be az MCP-szerver:
claude mcp add --transport http fotoai https://fotoai.hu/api/mcp --header "Authorization: Bearer fai_live_…"A parancssorból az első kép:
npx fotoai-cli login
npx fotoai-cli image "portré egy napfényes kávézóban" -a 3:4 --out ./kepekA CLI minden generálás előtt megmutatja az árat kreditben, és megerősítést kér. Az AI-ügynököknek szóló útmutatót egy paranccsal telepítheted: npx fotoai-cli skill install (részletek).