Generálj betűtípusokat, kérj le glifákat és kezeld a kiszolgálást programból. Ugyanaz a motor, mint az alkalmazásban — egyetlen bearer token választ el tőle.
Minden kérés bearer tokent használ a Authorization fejlécben. Tartsd szerveroldalon.
Jelentkezz be éles API-kulcsért — az API- és MCP-hozzáférés a Pro és a Studio csomag része.
Jelentkezz be a kulcsodértA korlátok API-kulcsonként érvényesek. A korlát túllépése ezt adja vissza: 429 Too Many Requests ezzel: Retry-After. A korlátok a csomagoddal együtt nőnek:
| Betűtípus létrehozása · minden más | |
| Pro | 200 · 2 000 / perc |
| Studio | 600 · 6 000 / perc |
Nagyobb áteresztőképesség kell? Válts nagyobb csomagra.
Teljes betűcsalád generálása szöveges promptból és/vagy referenciaképből. Egy feladatot ad vissza, amelynek állapotát lekérdezheted.
| promptkötelező | A betűtípus leírása hétköznapi nyelven. Optional when reference_image_url is set. |
| reference_image_url | Stílus-referenciakép (PNG/JPG/WEBP) — közvetlen, nyilvános URL. Soha nem tároljuk; a linket változatlanul továbbítjuk a renderelőmotornak, ugyanúgy, mint a Figma/Chrome bővítmények képernyőkép-alapú funkciója. |
| languages | ISO-kódok tömbje — alapértelmezése ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | pl. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Lekérdezi a betűtípus állapotát és a letöltési URL-eket (TTF / WOFF2 / variable).
Az elkészült betűtípusfájl letöltése adott formátumban (ttf/otf/woff/woff2) — pontosan ugyanaz a fájl, amit a Stúdió letöltés gombja ad.
Minden támogatott ISO-2 nyelvkód, írásrendszerenkénti glifaszámmal és szövegiránnyal — ebből állíthatsz össze érvényes "languages" tömböt.
Az utolsó 100 betűtípus-feladatod — állapot, modell, forrás és hivatkozás az egyes betűtípusok oldalára.
A generálás aszinkron. A generate POST után kérdezd le ezt: GET /api/public/status?link=… néhány másodpercenként, amíg az állapot font_ready (vagy failed) nem lesz.
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — hány glifaatlasz készült el |
| fonts | a ttf/otf/woff/woff2 fájlok URL-jei, amint status = font_ready. Ezekhez az URL-ekhez kell az API-kulcsod — Authorization fejléc nélkül 403-at adnak. A bájtokat ezen keresztül töltsd le: GET /api/public/download?link=…&format=…. |
Bőven elég 3–5 másodpercenként lekérdezni — egy teljes betűcsalád általában pár percen belül elkészül. A fájlokat a GET /api/public/download végponton át töltsd le az API-kulcsoddal; a „fonts" alatti URL-ek nem érhetők el nyilvánosan.
Minden hiba egységes JSON-formátumot követ: { "success": false, "error": "…" }.
| 400 | Hibás kérés — hiányzó vagy érvénytelen mezők. Nézd meg a error a részletekért. |
| 401 | Nincs jogosultság — hiányzó vagy érvénytelen Authorization fejléc. |
| 402 | Fizetés szükséges — elfogyott a glifakeret. Tölts fel a Csomagok oldalon. |
| 403 | Tiltott — a hivatkozás másik fiókhoz tartozik. |
| 404 | Nem található — a betűtípus azonosítója nem létezik, vagy másik fiókhoz tartozik. |
| 429 | Túl sok kérés — elérted a kérési korlátot. Próbáld újra ennyi idő után: Retry-After. |
| 500 | Belső hiba — nálunk hiba történt. Néhány másodperc múlva újrapróbálva általában sikerül. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
Az MCP (Model Context Protocol) lehetővé teszi, hogy az AI-kódolóügynökök — Claude Code, Cursor, Codex és mások — munka közben közvetlenül hívják a YoFontot: generálnak egy betűtípust beszélgetés közben, megvárják az elkészülését, és a fájlt egyből beteszik a projektedbe. Nincs több curl-parancs másolgatás.
Minden MCP-eszközhívás vékony, átlátható burok ugyanazokra a REST-végpontokra, amelyeket az API fülön dokumentálunk — ugyanaz a hitelesítés, ugyanazok a korlátok, ugyanaz az ellenőrzés. Az MCP-kiszolgáló semmit sem csinál, ami ne szerepelne a REST-dokumentációban.
Másold ki az alábbi promptot, és illeszd be a Claude Code-ba, a Cursorba vagy a Codexbe. Az ügynököd maga regisztrálja és ellenőrzi a YoFont MCP-kiszolgálót — nem kell kézzel konfigurációs fájlt szerkesztened.
A kulcsodat az API fül Hitelesítés szakaszában találod.
Irányítsd az MCP-klienset ide: https://yofont.com/api/public/mcp. Streamable HTTP átvitelt beszél (JSON válasz mód) — hívásonként egy JSON-RPC 2.0 kérés, nincs nyitva tartandó munkamenet vagy socket.
| Átvitel | Streamable HTTP (JSON-RPC 2.0 POST-on). Metódusok: initialize, ping, tools/list, tools/call. |
| Hitelesítés | Ugyanaz az API-kulcs, mint a REST API-nál — küldd fejlécként minden kérésben: Authorization: Bearer yf_live_.... |
Öt eszköz, egy az egyben megfeleltetve az API fül REST-végpontjainak — semmi sincs az MCP-ben, ami ne lenne sima REST is.
Vadonatúj betűcsalád generálása promptból és/vagy referenciaképből. Azonnal visszatér egy lekérdezhető hivatkozással — ez aszinkron feladat, nem blokkoló hívás.
| prompt | Stílusleírás hétköznapi nyelven. Elhagyható, ha megadsz reference_image_url értéket. |
| reference_image_url | Közvetlen, nyilvános kép-URL — elég, ha a hívás pillanatában nyilvánosan letölthető. |
| languages, weights, glyph_types, model_tier | Ugyanaz a felépítés és ugyanazok az alapértékek, mint a REST-végpontnál — lásd az API fül Betűtípus létrehozása szakaszát. |
Egy betűtípus-feladat készültségének lekérdezése. Ha kész, visszaadja a ttf/otf/woff/woff2 fájlok URL-jét. Megjegyzés: ezek nem nyilvánosan letölthetők (403) — a bájtokért használd a download_font eszközt.
| linkkötelező | A generate_font által visszaadott betűtípus-hivatkozás. |
A betűtípusfájl bájtjait MCP-erőforrásként adja vissza, így az ügynököd egyből a projekted lemezére írhatja. Szokatlanul nagy fájl esetén sima URL-re vált vissza.
| linkkötelező | A generate_font által visszaadott betűtípus-hivatkozás. |
| format | ttf · otf · woff · woff2 — default ttf. |
Listázza az összes támogatott ISO-2 nyelvkódot glifaszámmal és szövegiránnyal — ebből állíthatsz össze érvényes languages tömböt.
Listázza az utolsó 100 betűtípus-feladatodat — állapot, modell, forrás és hivatkozás az egyes betűtípusok oldalára.
Az MCP-eszközök csak annyira jók, amennyire a mögöttük álló prompt. Ezekkel következetesen erős az eredmény:
„Generálj barátságos, lekerekített talpatlan betűtípust egy gyerekeknek szóló oktatóalkalmazáshoz, angolul és spanyolul, normal és bold vastagságban — aztán mentsd a ttf fájlokat a ./public/fonts mappába."
Megnevezi a hangulatot, a nyelveket, a vastagságokat és azt, hová kerüljön az eredmény — az ügynök felügyelet nélkül végigviheti az egészet.
„Itt egy képernyőkép a régi logónkról: https://example.com/logo.png — generálj ehhez a stílushoz illő display betűtípust, ultra minőségben, csak angolul."
Egy konkrét meglévő megjelenés visszaadásában a referenciakép jobb a jelzőknél — display és címsorbetűhöz megéri a model_tier: ultra.
„Nézd meg a 8WeheWlTl betűtípus állapotát, szólj, ha kész, aztán add meg a woff2 URL-t."
Egyszerű lekérdezés és jelentés — jó arra, hogy rákérdezz egy korábban indított feladatra.
„Milyen cirill és görög nyelveket támogat a YoFont? Olyan betűtípus kell, amely lefedi az oroszt, az ukránt és a görögöt."
Hagyd, hogy az ügynök meghívja a list_languages eszközt, ahelyett hogy fejből találgatná az ISO-kódokat — így egy elgépelt kód miatt nem bukik el a generate_font hívás.
„Generálj geometrikus display betűtípust ebből a referenciaképből, várd meg, míg elkészül, aztán töltsd le a ttf-et, és vedd fel a Tailwind konfigunkba egyedi font-face-ként."
Egyetlen utasításban fűzi össze mindhárom eszközt — generálás → lekérdezés → letöltés —, és konkrét következő lépést ad az ügynöknek.
„Mutasd meg az összes betűtípusomat, és mondd meg, melyik vár még sorra vagy hibázott el."
Jó egy teljes projekt gyors állapotfelmérésére anélkül, hogy megnyitnád a vezérlőpultot.
Egyetlen kérésed elindíthatja az egész folyamatot — a lekérdezési kört az ügynököd intézi, te csak az eredményt látod.