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

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: 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.

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:

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.

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.