Generéiert Schrëften, rufft Glyphen of a verwalt d'Ausliwwerung programmatesch. Dee selwechte Motor wéi d'App, nëmmen ee Bearer-Token ewech.
All Ufroe benotzen e Bearer-Token am Authorization-Header. Haalt en op der Serversäit.
Loggt Iech an, fir en aktiven API-Schlëssel ze generéieren — den API- a MCP-Zougang ass an den Abonnementer Pro a Studio abegraff.
Loggt Iech an, fir Äre Schlëssel ze kréienD'Ufroe si pro API-Schlëssel limitéiert. Wann d'Limit iwwerschratt gëtt, kënnt 429 Too Many Requests mat engem Retry-After. D'Limite wuesse mat Ärem Abonnement:
| Schrëft erstellen · alles anescht | |
| Pro | 200 · 2 000 / Min |
| Studio | 600 · 6 000 / Min |
Braucht Dir méi Duerchsatz? Ären Abonnement upgraden.
Generéiert eng komplett Schrëftfamill aus enger Beschreiwung an/oder engem Referenzbild. Gëtt eng Aufgab zréck, déi Dir bis zur Fäerdegstellung ofgefrot.
| promptobligatoresch | Beschreiwung vun der Schrëft a normale Wierder. Optional when reference_image_url is set. |
| reference_image_url | Stil-Referenzbild (PNG/JPG/WEBP) — eng direkt ëffentlech URL. Mir späicheren se ni; mir ginn de Link onverännert un de Rendermotor weider, genee wéi d'Screenshot-zu-Schrëft-Funktioun vun de Figma-/Chrome-Pluginen. |
| languages | Array vun ISO-Coden — Standard ass ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | z. B. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Rifft de Status an d'Download-URLen (TTF / WOFF2 / variabel) vun enger Schrëft of.
Luet déi gebaute Schrëftdatei an engem bestëmmte Format erof (ttf/otf/woff/woff2) — déiselwecht Datei, déi den Download-Knäppche vum Studio erausgëtt.
All ënnerstëtzten ISO-2-Sproochcode, mat Glyph-Zuelen pro Schrëftsystem an der Textrichtung — benotzt en, fir e gültegt „languages“-Array ze bauen.
Är lescht 100 Schrëftaufgaben — Status, Modell, Quell an e Link op d'Säit vun all Schrëft.
D'Generatioun ass asynchron. Nom POST op generate frot GET /api/public/status?link=… all e puer Sekonnen of, bis de Status font_ready (oder failed) ass.
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — wéi vill Glyph-Atlasse fäerdeg sinn |
| fonts | URLen vun den ttf-/otf-/woff-/woff2-Dateien, do soubal status = font_ready. Dës URLe brauchen Äre API-Schlëssel — se ouni den Authorization-Header ofzeruffe gëtt 403. Lued d'Bytes erof iwwer GET /api/public/download?link=…&format=…. |
En Ofruff all 3–5 Sekonnen duergeet — eng komplett Famill ass normalerweis an ënner zwou Minutte fäerdeg. Rufft d'Dateien iwwer GET /api/public/download mat Ärem API-Schlëssel of; d'URLen an „fonts“ sinn net ëffentlech zougänglech.
All Feeler hunn déiselwecht JSON-Form: { "success": false, "error": "…" }.
| 400 | Ongülteg Ufro — feelend oder ongülteg Felder. Kontrolléiert de error fir Detailer. |
| 401 | Net autoriséiert — feelend oder ongülteg Authorization -Header. |
| 402 | Bezuelung néideg — Glyph-Kontingent opgebraucht. Luet op der Abonnementssäit op. |
| 403 | Verbueden — de Link gehéiert engem anere Kont. |
| 404 | Net fonnt — d'Schrëft-ID gëtt et net oder si gehéiert engem anere Kont. |
| 429 | Ze vill Ufroen — Ufrolimit erreecht. Probéiert nach eng Kéier no Retry-After. |
| 500 | Interne Feeler — bei eis ass eppes schif gaangen. En neie Versuch no e puer Sekonne klappt normalerweis. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) léisst KI-Programméieragenten — Claude Code, Cursor, Codex an anerer — YoFont direkt wärend der Aarbecht opruffen: eng Schrëft mëtten am Gespréich generéieren, op de Bau waarden an d'Datei direkt an Äre Projet leeën. Kee Kopéiere vu curl-Kommandoen.
All MCP-Toolopruff ass eng dënn, transparent Hüll iwwer déiselwecht REST-Endpunkten, déi am API-Tab dokumentéiert sinn — selwecht Authentifikatioun, selwecht Limiten, selwecht Validéierung. Näischt, wat de MCP-Server mécht, ass virun der REST-Dokumentatioun verstoppt.
Kopéiert d'Beschreiwung hei ënnen a koppt se an Claude Code, Cursor oder Codex. Ären Agent registréiert de YoFont-MCP-Server selwer a kontrolléiert en — keng Konfiguratiounsdateie fir vun Hand z'änneren.
Kritt Äre Schlëssel am Abschnëtt Authentifikatioun um API-Tab.
Riicht Äre MCP-Client op https://yofont.com/api/public/mcp. Hie schwätzt den Transport Streamable HTTP (JSON-Äntwertmodus) — eng JSON-RPC-2.0-Ufro pro Opruff, keng Sessioun oder Socket, déi opbleiwe muss.
| Transport | Streamable HTTP (JSON-RPC 2.0 iwwer POST). Methoden: initialize, ping, tools/list, tools/call. |
| Authentifikatioun | Dee selwechten API-Schlëssel wéi bei der REST-API — schéckt en als Header bei all Ufro: Authorization: Bearer yf_live_.... |
Fënnef Tools, een zu een mat de REST-Endpunkten um API-Tab — et gëtt näischt am MCP, wat net och einfach REST ass.
Generéiert eng ganz nei Schrëftfamill aus enger Beschreiwung an/oder engem Referenzbild. Gëtt direkt e Link zréck, deen ofgefrot gëtt — dat ass eng asynchron Aufgab, kee blockéierenden Opruff.
| prompt | Stilbeschreiwung a normale Wierder. Fakultativ, wann reference_image_url uginn ass. |
| reference_image_url | Direkt ëffentlech Bild-URL — si muss just zum Zäitpunkt vum Opruff ëffentlech ofruffbar sinn. |
| languages, weights, glyph_types, model_tier | Selwecht Form a selwecht Standardwäerter wéi beim REST-Endpunkt — kuckt den Abschnëtt „Schrëft erstellen“ um API-Tab. |
Freet de Baufortschrëtt vun enger Schrëftaufgab of. Soubal se prett ass, ginn d'URLen vun den ttf-/otf-/woff-/woff2-Dateien zréckginn. Opgepasst: si sinn net ëffentlech ofruffbar (403) — benotzt d'Tool download_font, fir d'Bytes ze kréien.
| linkobligatoresch | De Schrëftlink, deen generate_font zréckginn huet. |
Rifft d'Bytes vun enger Schrëftdatei inline als MCP-Ressource of, sou datt Ären Agent se direkt an Ärem Projet op d'Disk schreiwe kann. Fällt op eng einfach URL zréck, wann d'Datei ongewéinlech grouss ass.
| linkobligatoresch | De Schrëftlink, deen generate_font zréckginn huet. |
| format | ttf · otf · woff · woff2 — default ttf. |
Lëscht all ënnerstëtzten ISO-2-Sproochcode mat Glyph-Zuelen an Textrichtung op — benotzt se, fir e gültegt languages-Array ze bauen.
Lëscht Är lescht 100 Schrëftaufgaben op — Status, Modell, Quell an e Link op d'Säit vun all Schrëft.
MCP-Tools si just sou gutt wéi d'Beschreiwung hannendrun. Dës hei bréngen ëmmer erëm staark Resultater:
„Generéier eng frëndlech, ofgerënnte Sans-Serif fir eng Kanner-Léier-App, op Englesch a Spuenesch, an de Schnëtter normal a bold — a späicher duerno d'ttf-Dateien an ./public/fonts.“
Nennt d'Stëmmung, d'Sproochen, d'Schnëtter a wou d'Resultat higoe soll — den Agent kann de ganze Loop ouni Opsiicht duerchlafen.
„Hei ass e Screenshot vun eisem ale Logo: https://example.com/logo.png — generéier eng Display-Schrëft, déi zu sengem Stil passt, ultra Qualitéit, nëmmen Englesch.“
Referenzbiller schloen Adjektiver, wann et drëms geet, e bestëmmte bestehende Look ze treffen — model_tier: ultra lount sech fir Titel- an Display-Schrëften.
„Kuck de Status vun der Schrëft 8WeheWlTl no a sot mer, wa se prett ass, a gëff mer duerno d'woff2-URL.“
En einfacht Ofruffen a Mellen — gutt, fir eng Aufgab nozekucken, déi Dir virdrun am Gespréich gestart hutt.
„Wéi eng kyrillesch a griichesch Sproochen ënnerstëtzt YoFont? Ech brauch eng Schrëft, déi Russesch, Ukrainesch a Griichesch ofdeckt.“
Loosst den Agent list_languages opruffen, amplaz ISO-Coden aus dem Gediechtnes ze roden — dat verhënnert e feelgeschloene generate_font-Opruff wéinst engem Tippfeeler am Code.
„Generéier eng geometresch Display-Schrëft aus dësem Referenzbild, waart, bis se fäerdeg ass, lued duerno d'ttf erof a setz se an eiser Tailwind-Konfiguratioun als eege font-face derbäi.“
Kettéiert all dräi Tools an enger eenzeger Instruktioun — generéieren → ofruffen → eroflueden — a gëtt dem Agent e konkreten nächste Schrëtt.
„Weis mer all meng Schrëften a sot mer, wéi eng nach an der Schlaang sinn oder feelgeschloe sinn.“
Gutt fir en Iwwerbléck iwwer e ganze Projet, ouni d'Dashboard opzemaachen.
Eng eenzeg Ufro vun Iech kann déi ganz Kette ustoussen — Ären Agent iwwerhëlt de Loop, an Dir gesitt just d'Resultat.