Vytvářejte písma, načítejte glyfy a spravujte doručení programově. Stejný engine jako aplikace, na jeden token bearer daleko.
Všechny požadavky používají token bearer v hlavičce Authorization. Držte ho na serveru.
Přihlaste se a vygenerujte si živý klíč k API — přístup k API a MCP je součástí tarifů Pro a Studio.
Přihlaste se a získejte svůj klíčPožadavky jsou omezené na klíč k API. Překročení limitu vrátí 429 Too Many Requests s Retry-After. Limity rostou s vaším tarifem:
| Vytvořit písmo · všechno ostatní | |
| Pro | 200 · 2 000 / min |
| Studio | 600 · 6 000 / min |
Potřebujete vyšší průchodnost? Přejít na vyšší tarif.
Vytvoří kompletní rodinu písem z textové výzvy nebo z referenčního obrázku. Vrátí úlohu, na jejíž dokončení se dotazujete.
| promptpovinné | Popis písma běžným jazykem. Optional when reference_image_url is set. |
| reference_image_url | Referenční obrázek stylu (PNG/JPG/WEBP) — přímá veřejná adresa. Neukládáme ho; odkaz předáváme beze změny vykreslovacímu enginu, stejně jako „ze snímku obrazovky písmo“ v pluginech pro Figma a Chrome. |
| languages | Pole kódů ISO — výchozí hodnota ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | např. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Načte stav písma a adresy ke stažení (TTF / WOFF2 / variabilní).
Stáhne sestavený soubor písma v konkrétním formátu (ttf/otf/woff/woff2) — stejný soubor, jaký dá tlačítko stažení ve Studiu.
Všechny podporované kódy jazyků ISO-2 s počty glyfů podle písma světa a směrem textu — použijte je k sestavení platného pole „languages“.
Vašich posledních 100 úloh — stav, model, zdroj a odkaz na stránku každého písma.
Generování je asynchronní. Po POST na generate se dotazujte na GET /api/public/status?link=… každých pár sekund, dokud stav není font_ready (nebo failed).
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — kolik atlasů glyfů je hotových |
| fonts | adresy souborů ttf/otf/woff/woff2, přítomné jakmile status = font_ready. Tyto adresy vyžadují váš klíč k API — bez hlavičky Authorization vrátí 403. Bajty stáhněte přes GET /api/public/download?link=…&format=…. |
Dotaz každé 3–5 sekundy bohatě stačí — celá rodina je obvykle hotová do pár minut. Soubory načítejte přes GET /api/public/download se svým klíčem k API; adresy v „fonts“ veřejně dostupné nejsou.
Všechny chyby mají jednotný tvar JSON: { "success": false, "error": "…" }.
| 400 | Chybný požadavek — chybějící nebo neplatná pole. Zkontrolujte error pro podrobnosti. |
| 401 | Neautorizováno — chybějící nebo neplatná Authorization hlavička. |
| 402 | Vyžadována platba — vyčerpaná kvóta glyfů. Dobijte ji na stránce Tarify. |
| 403 | Zakázáno — odkaz patří jinému účtu. |
| 404 | Nenalezeno — ID písma neexistuje nebo patří jinému účtu. |
| 429 | Příliš mnoho požadavků — narazili jste na limit. Zkuste to znovu po Retry-After. |
| 500 | Interní chyba — něco se pokazilo na naší straně. Opakování za pár sekund obvykle pomůže. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) umožňuje programovacím AI agentům — Claude Code, Cursor, Codex a dalším — volat YoFont přímo za chodu: vytvořit písmo uprostřed konverzace, počkat, až se sestaví, a soubor rovnou umístit do vašeho projektu. Žádné kopírování příkazů curl.
Každé volání nástroje MCP je tenká a průhledná nadstavba nad stejnými endpointy REST popsanými na kartě API — stejná autorizace, stejné limity, stejná validace. Server MCP nedělá nic, co by dokumentace REST zamlčovala.
Zkopírujte výzvu níž a vložte ji do Claude Code, Cursoru nebo Codexu. Váš agent si server MCP od YoFontu zaregistruje sám a ověří ho — žádné konfigurační soubory k ruční úpravě.
Klíč získáte v sekci Autentizace na kartě API.
Nasměrujte svého klienta MCP na https://yofont.com/api/public/mcp. Mluví přenosem Streamable HTTP (režim odpovědi JSON) — jeden požadavek JSON-RPC 2.0 na volání, žádná relace ani socket k držení.
| Přenos | Streamable HTTP (JSON-RPC 2.0 přes POST). Metody: initialize, ping, tools/list, tools/call. |
| Autorizace | Stejný klíč k API jako u REST API — posílejte ho v hlavičce u každého požadavku: Authorization: Bearer yf_live_.... |
Pět nástrojů, jeden ku jednomu s endpointy REST na kartě API — v MCP neexistuje nic, co by nebylo i v běžném REST.
Vytvoří zbrusu novou rodinu písem z výzvy nebo z referenčního obrázku. Vrátí se okamžitě s odkazem k dotazování — je to asynchronní úloha, ne blokující volání.
| prompt | Popis stylu běžným jazykem. Nepovinné, pokud zadáte reference_image_url. |
| reference_image_url | Přímá veřejná adresa obrázku — stačí, aby byl v okamžiku volání veřejně dostupný. |
| languages, weights, glyph_types, model_tier | Stejný tvar i výchozí hodnoty jako u endpointu REST — viz sekci Vytvořit písmo na kartě API. |
Dotáže se na průběh sestavování písma. Jakmile je hotové, vrátí adresy souborů ttf/otf/woff/woff2. Pozor: veřejně se stáhnout nedají (403) — bajty získáte nástrojem download_font.
| linkpovinné | Odkaz na písmo, který vrátil generate_font. |
Načte bajty souboru písma jako zdroj MCP, takže je váš agent může zapsat rovnou na disk ve vašem projektu. U neobvykle velkých souborů se vrátí jen adresa.
| linkpovinné | Odkaz na písmo, který vrátil generate_font. |
| format | ttf · otf · woff · woff2 — default ttf. |
Vypíše všechny podporované kódy jazyků ISO-2 s počty glyfů a směrem textu — použijte je k sestavení platného pole languages.
Vypíše vašich posledních 100 úloh — stav, model, zdroj a odkaz na stránku každého písma.
Nástroje MCP jsou jen tak dobré jako výzva za nimi. Tyhle dávají stabilně silné výsledky:
„Vytvoř přívětivé zaoblené bezpatkové písmo pro vzdělávací aplikaci pro děti, v angličtině a španělštině, řezy normal a bold — pak soubory ttf ulož do ./public/fonts.“
Pojmenuje náladu, jazyky, řezy i to, kam výsledek uložit — agent zvládne celou smyčku bez dozoru.
„Tady je snímek našeho starého loga: https://example.com/logo.png — vytvoř display písmo odpovídající jeho stylu, kvalita ultra, jen angličtina.“
Při napodobování konkrétního existujícího vzhledu porazí referenční obrázky jakékoli přívlastky — model_tier: ultra se u hlavního a display písma vyplatí.
„Zkontroluj stav písma 8WeheWlTl a řekni mi, až bude hotové, pak mi dej adresu woff2.“
Prosté dotázání a hlášení — hodí se na kontrolu úlohy, kterou jste spustili dřív v konverzaci.
„Které jazyky v cyrilici a řečtině YoFont podporuje? Potřebuju písmo pokrývající ruštinu, ukrajinštinu a řečtinu.“
Nechte agenta zavolat list_languages místo hádání kódů ISO z paměti — vyhnete se neúspěšnému volání generate_font kvůli překlepu v kódu.
„Vytvoř geometrické display písmo z tohoto referenčního obrázku, počkej, až bude hotové, pak stáhni ttf a přidej ho do naší konfigurace Tailwindu jako vlastní font-face.“
Zřetězí všechny tři nástroje v jediné instrukci — vytvořit → dotázat se → stáhnout — a dá agentovi konkrétní další krok.
„Ukaž mi všechna moje písma a řekni, která jsou pořád ve frontě nebo selhala.“
Hodí se na rychlý přehled stavu celého projektu bez otevírání dashboardu.
Jediný požadavek od vás může spustit celý řetězec — váš agent obstará dotazovací smyčku, vy uvidíte jen výsledek.