---
title: "Áttekintés és kezdés | FotóAI fejlesztői dokumentáció"
description: "A FotóAI fejlesztői felületei: MCP-szerver, parancssori kliens (CLI) és a partner REST API. API-kulcs vagy OAuth, és mikor melyik."
canonical: https://fotoai.hu/dokumentacio
source: https://fotoai.hu/dokumentacio.md
---

#### 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](https://fotoai.hu/dokumentacio/mcp) | 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](https://fotoai.hu/dokumentacio/cli) | Parancssor és szkriptek: árajánlat, generálás, várakozás, letöltés egy paranccsal. | `npx fotoai-cli` |
| [REST API v1](https://fotoai.hu/dokumentacio/api) | 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](https://fotoai.hu/beallitasok/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](https://fotoai.hu/beallitasok/kapcsolt-alkalmazasok) → 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

1. Jelentkezz be, és nyisd meg a [Beállítások → API-kulcsok](https://fotoai.hu/beallitasok/api-kulcsok) oldalt (vagy az [MCP/CLI](https://fotoai.hu/mcp) oldalt).
2. Adj nevet a kulcsnak (például „Claude Code”), és hozd létre.
3. 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 Code

```
claude mcp add --transport http fotoai https://fotoai.hu/api/mcp --header "Authorization: Bearer fai_live_…"
```

A parancssorból az első kép:

Terminál

```
npx fotoai-cli login
npx fotoai-cli image "portré egy napfényes kávézóban" -a 3:4 --out ./kepek
```

A 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](https://fotoai.hu/dokumentacio/cli#skill)).

[Következő → · MCP-szerver](https://fotoai.hu/dokumentacio/mcp)