# AI-szolgáltató beállítása: OpenAI, Gemini, Mistral, Claude és DeepSeek

> Hogyan kösd össze a SEOPress PRO-t a saját AI-fiókoddal: API-kulcs létrehozása, megadása, tesztelése és a gyakori hibák.

A SEOPress PRO az AI-funkciókhoz (címek, meta leírások, közösségi metaadatok, képek szöveges metaadatai) a saját AI-szolgáltatód API-ját hívja. Ehhez szolgáltatónként egy API-kulcs kell, és az adott szolgáltatónál annyi egyenleg, amennyit a hívások használnak.

> **Megjegyzés**
>
> Egy ChatGPT- vagy Claude-előfizetés nem tartalmaz API-egyenleget. Ha inkább az előfizetéseddel szeretnéd használni a webhelyedet a ChatGPT-ből vagy a Claude-ból, használd az [MCP-szervert](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/ai-mcp-szerver/): ahhoz nem kell API-kulcs.

## Támogatott szolgáltatók

A **SEO → PRO → AI** oldal **Általános beállítások** részében az **AI-szolgáltató** mezőnél hat csempe közül választasz: SEOPress (AI-kreditek), OpenAI, DeepSeek, Gemini, Mistral és Claude.

![A SEO → PRO → AI oldal a szolgáltatóválasztó csempékkel és az automatikus generálás beállításaival](./kepek/ai-beallitasok.webp)

*A SEO → PRO → AI oldal a szolgáltatóválasztó csempékkel és az automatikus generálás beállításaival* (https://minta-bolt.hu/wp-admin/admin.php?page=seopress-pro-page)

Az oldal tetején az **AI** funkció kapcsolója van. Ha ki van kapcsolva, kapcsold be, és mentsd a beállításokat.

## Mit küld a SEOPress a szolgáltatónak?

A jobb találat érdekében a következők mennek ki:

- a bejegyzés tartalma (ha az nem megy, a bejegyzés URL-je),
- a bejegyzés nyelve,
- a megadott célkulcsszavak (és a kérés része, hogy legalább az egyik szerepeljen a generált metaadatban).

Képek szöveges metaadatainál a kép fájlja kerül elküldésre (ha lehet, a szerverről olvasva), és a nyelv, amelyen a szöveget írni kell. A szolgáltató válaszát a SEOPress nem tudja befolyásolni, ezért mentés előtt mindig nézd át a szöveget.

## A szolgáltatók beállítása

Minden szolgáltatónál ugyanaz a menet: fiók létrehozása, API-kulcs készítése, a kulcs beillesztése a SEOPressbe, mentés. A **SEO → PRO → AI** oldalon válaszd ki a szolgáltatót, írd be a kulcsot a megjelenő mezőbe, és kattints a **Save changes** gombra.

| Szolgáltató | Mit kell tenned a szolgáltatónál | Megjegyzés |
|---|---|---|
| OpenAI | Regisztrálj az OpenAI platformján, a vezérlőpult API-kulcsok oldalán kattints az új titkos kulcs létrehozására, adj nevet és projektet, majd másold ki a kulcsot. | Az API-kulcs kell, nem a ChatGPT-hozzáférés. A GPT-4/5 Vision modellekhez a platformon legalább egy kisebb összegű befizetés kell. |
| Gemini | Hozz létre fiókot a Google AI Stúdióban, az API-kulcsok oldalon hozz létre egy kulcsot (név és projekt kell hozzá), majd másold ki a listából. | Érdemes bankkártyát rögzíteni, hogy a Google Cloud-fiókban ne legyen hiba. A használatot a Stúdióban követheted. |
| Mistral | Regisztrálj a Mistralnál, az AI Studio konzolon az API-kulcsok pontnál hozz létre új kulcsot (név és opcionális lejárati dátum), és másold ki. | A konzolban be kell kapcsolni a használat szerinti fizetést (Pay as you go). |
| Claude | A Claude platformján az API-kulcs kérésével hozz létre kulcsot (név és munkaterület), és másold ki. | Az új fiók kap kezdő kreditet, de érdemes bankkártyát rögzíteni a számlázási oldalon. |
| DeepSeek | Regisztrálj, tölts fel egyenleget (kártyával vagy PayPallal), az API-kulcsok oldalon hozz létre kulcsot, nevezd el, és másold ki. | A DeepSeek modellje nem tud képet olvasni, ezért a képek metaadataihoz másik szolgáltatót használj (az OpenAI-t javasolják). |

### A kulcs tárolása a wp-config.php fájlban

Ha nem szeretnéd, hogy a kulcs az adatbázisban legyen (például multisite-nál, vagy a nagyobb biztonságért), a `wp-config.php` fájlba is beírhatod. Szolgáltatónként egy sor:

```php
define( 'SEOPRESS_OPENAI_KEY', 'XXXXXXX' );
define( 'SEOPRESS_GEMINI_KEY', 'XXXXXXX' );
define( 'SEOPRESS_MISTRAL_KEY', 'XXXXXXX' );
define( 'SEOPRESS_CLAUDE_KEY', 'XXXXXXX' );
define( 'SEOPRESS_DEEPSEEK_KEY', 'XXXXXXX' );
```

## A kulcs tesztelése és a naplók

A szolgáltató mezője mellett a kulcs kipróbálható a **Test API key** (OpenAI-nál **Test connection**) gombbal: néhány másodperc múlva pozitív vagy negatív választ kapsz. Az oldal alján az **AI naplók** részben az AI-tól kapott legutóbbi hibaüzenetek látszanak; ha nincs hiba, azt írja: „Jelenleg nincs naplózott hiba.”

## Gyakori hibák

### Közös hibakódok

| Kód | Jelentése | Mit tegyél |
|---|---|---|
| 400 | Hibás kérés. Tűzfal is okozhatja. | Ha tűzfalat használsz, engedélyezd a szolgáltató domainjét (OpenAI-nál az openai.com-ot). A 6G/7G/8G szabálykészletek blokkolhatják, kapcsold ki őket vagy tegyél kivételt. Egyébként általában bővítményhiba, szólj a támogatásnak. |
| 401 | Érvénytelen kulcs. | Ellenőrizd, hogy API-kulcsot adtál meg (nem ChatGPT-kulcsot), és hogy pontosan másoltad. |
| 403 | A kulcsnak nincs joga ehhez. | Gemininél ellenőrizd, hogy a Google Cloud projektben be van kapcsolva a Gemini API és a kulcsnak van jogosultsága. Mistralnál és Claude-nál nézd meg, hogy a csomagod tartalmazza a használt funkciót vagy modellt. |
| 404 | A modell nem található (Gemini). | Nézd meg, hogy létező modellnevet választottál. |
| 429 | Túl sok kérés, vagy elfogyott az egyenleg. | Várj egy percet, és próbáld újra. Nézd meg a kvótát vagy a számlázást, és hogy a kulcs nem járt-e le. |
| 500, 503, 529 | A szolgáltató oldalán hiba van vagy túlterhelt. | Várj 30-60 másodpercet, és próbáld újra. |

### OpenAI: a 429 gyakori okai

- a kulcs lejárt az OpenAI-fiókban,
- ChatGPT-előfizetést használsz API-kulcs helyett,
- az OpenAI épp nem működik,
- túl gyorsan küldöd a kéréseket,
- a böngésző automatikus kitöltése felülírta a kulcsot, amikor a SEO → PRO más beállításait mentetted,
- lejárt az ingyenes próba, vagy nincs egyenleg a fiókban.

### DeepSeek hibák

| Kód | Teendő |
|---|---|
| 400 | Hibás formátum: az üzenet tippjei szerint javítsd a kérést. |
| 401 | Ellenőrizd a kulcsot, vagy hozz létre újat. |
| 402 | Elfogyott az egyenleg: tölts fel a DeepSeek fiókjában. |
| 422 | Érvénytelen paraméterek: az üzenet szerint javítsd. |
| 429 | Túl gyors kérések: lassíts, vagy átmenetileg válts másik szolgáltatóra. |
| 500, 503 | Szerveroldali hiba vagy túlterhelés: várj, és próbáld újra. |

### „A fiókod nem használhatja a kiválasztott modellt”

Egyes szolgáltatók projektenként vagy kulcsonként csak bizonyos modelleket engednek. Ha a szolgáltatód elutasítja a kiválasztott modellt, a SEOPress PRO automatikusan átvált ugyanannak a szolgáltatónak egy másik modelljére (az olcsóbbakkal kezdi), újraküldi a kérést, és a továbbiakban azt használja. A csere bekerül az AI naplóba. Ez modelljogosultság, nem számlázási korlát.

A visszatéréshez engedélyezd a modellt a szolgáltató vezérlőpultján a projektedhez, majd mentsd újra az AI-beállításokat. A szolgáltató, a modell vagy a kulcs módosítása is törli az elutasított modellek listáját, egyébként hat óra után maguktól elfelejtődnek. Ha a fiók egyik elérhető modellt sem használhatja, nem készül semmi, és a hibaüzenet ezt jelzi.

### Érvénytelen kép

Ha a képnél hibát kapsz, ellenőrizd, hogy a melléklet létezik, és a WordPress el tudja olvasni. Távoli vagy külső tárolóra kiszervezett médiánál a szervernek le kell tudnia tölteni a fájlt, és a hitelesítés vagy tűzfal nem akadályozhatja. A támogatott képtípusokról lásd a [képek metaadatainak generálását](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/ai-kepek-metaadatai/).

Helyi vagy védett webhely nincs automatikusan kizárva: a mellékletet a lemezről is el lehet olvasni, így nem kell nyilvános letöltés. Ehhez is kell viszont támogatott kép, megfelelő modell és működő kimenő API-hozzáférés. Ha a hiba megmarad, küldd el a támogatásnak a hibaüzenetet és a lépéseket (az API-kulcs nélkül).

## Fejlesztőknek

A modellek kipróbálási sorrendje a `seopress_ai_model_fallback_order` szűrővel módosítható: megkapja a modellnevek listáját (az első próbálkozik elsőként) és a szolgáltatót.