Skep lettertipes, haal gliewe en bestuur aflewering programmaties. Dieselfde enjin as die toepassing, net een bearer-token daarvandaan.
Alle versoeke gebruik 'n bearer-token in die Authorization-kopstuk. Hou dit aan die bedienerkant.
Meld aan om 'n lewende API-sleutel te skep — API- en MCP-toegang is by die Pro- en Studio-pakkette ingesluit.
Meld aan om jou sleutel te kryVersoeke word per API-sleutel beperk. As jy die limiet oorskry, kry jy 429 Too Many Requests met 'n Retry-After. Die limiete skaal saam met jou pakket:
| Skep lettertipe · al die res | |
| Pro | 200 · 2 000 / min |
| Studio | 600 · 6 000 / min |
Meer deurset nodig? Gradeer jou pakket op.
Skep 'n volledige letterfamilie uit 'n teksbeskrywing en/of 'n verwysingsprent. Dit gee 'n taak terug wat jy peil totdat dit klaar is.
| promptverpligtend | Beskrywing van die lettertipe in gewone taal. Optional when reference_image_url is set. |
| reference_image_url | Stylverwysingsprent (PNG/JPG/WEBP) — 'n direkte openbare URL. Ons stoor dit nooit nie; ons stuur die skakel net so aan na die tekenenjin, net soos die Figma-/Chrome-inproppe se skermskoot-na-lettertipe. |
| languages | Skikking van ISO-kodes — verstek is ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | bv. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Haal 'n lettertipe se status en aflaai-URL's (TTF / WOFF2 / variabel).
Laai die gebou lettertipelêer in 'n spesifieke formaat af (ttf/otf/woff/woff2) — dieselfde lêer wat die Ateljee se aflaaiknoppie lewer.
Elke ondersteunde ISO-2-taalkode, met glieftellings per skrifstelsel en teksrigting — gebruik dit om 'n geldige "languages"-skikking te bou.
Jou laaste 100 lettertipetake — status, model, bron en 'n skakel na elke lettertipe se bladsy.
Generering is asinkronies. Nadat jy na generate ge-POST het, peil GET /api/public/status?link=… elke paar sekondes totdat die status font_ready (of failed) is.
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — hoeveel gliefatlasse klaar is |
| fonts | ttf-/otf-/woff-/woff2-lêer-URL's, teenwoordig sodra status = font_ready. Hierdie URL's vereis jou API-sleutel — as jy hulle sonder die Authorization-kopstuk haal, kry jy 403. Laai die grepe af deur GET /api/public/download?link=…&format=…. |
Een peiling elke 3–5 sekondes is genoeg — 'n volledige familie is gewoonlik binne 'n paar minute klaar. Haal die lêers deur GET /api/public/download met jou API-sleutel; die URL's in "fonts" is nie openbaar toeganklik nie.
Alle foute volg 'n konsekwente JSON-vorm: { "success": false, "error": "…" }.
| 400 | Slegte versoek — ontbrekende of ongeldige velde. Kyk na die error vir besonderhede. |
| 401 | Nie gemagtig nie — ontbrekende of ongeldige Authorization kopstuk. |
| 402 | Betaling benodig — die gliefkwota is op. Vul aan op die Pakkette-bladsy. |
| 403 | Verbode — die skakel behoort aan 'n ander rekening. |
| 404 | Nie gevind nie — die lettertipe-ID bestaan nie of behoort aan 'n ander rekening. |
| 429 | Te veel versoeke — die tempolimiet is bereik. Probeer weer ná Retry-After. |
| 500 | Interne fout — iets het aan ons kant verkeerd geloop. 'n Herprobeer ná 'n paar sekondes werk gewoonlik. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) laat KI-kodeeragente — Claude Code, Cursor, Codex en ander — YoFont direk aanroep terwyl hulle werk: 'n lettertipe midde-in 'n gesprek skep, wag dat dit klaar bou, en die lêer reguit in jou projek plaas. Geen curl-opdragte om te kopieer en plak nie.
Elke MCP-gereedskapaanroep is 'n dun, deursigtige omhulsel oor dieselfde REST-eindpunte wat op die API-oortjie gedokumenteer word — dieselfde verifikasie, dieselfde tempolimiete, dieselfde validering. Niks wat die MCP-bediener doen, is van die REST-dokumentasie weggesteek nie.
Kopieer die beskrywing hieronder en plak dit in Claude Code, Cursor of Codex. Jou agent registreer die YoFont MCP-bediener self en verifieer dit — geen konfigurasielêers om met die hand te wysig nie.
Kry jou sleutel by die Verifikasie-afdeling op die API-oortjie.
Rig jou MCP-kliënt op https://yofont.com/api/public/mcp. Dit praat Streamable HTTP-vervoer (JSON-antwoordmodus) — een JSON-RPC 2.0-versoek per aanroep, geen sessie of sok om oop te hou nie.
| Vervoer | Streamable HTTP (JSON-RPC 2.0 oor POST). Metodes: initialize, ping, tools/list, tools/call. |
| Verifikasie | Dieselfde API-sleutel as die REST-API — stuur dit as 'n kopstuk op elke versoek: Authorization: Bearer yf_live_.... |
Vyf gereedskapstukke, een-tot-een met die REST-eindpunte op die API-oortjie — niks bestaan in MCP wat nie ook gewone REST is nie.
Skep 'n splinternuwe letterfamilie uit 'n beskrywing en/of 'n verwysingsprent. Dit keer dadelik terug met 'n skakel om te peil — dit is 'n asinkroniese taak, nie 'n blokkerende aanroep nie.
| prompt | Stylbeskrywing in gewone taal. Opsioneel as reference_image_url gegee word. |
| reference_image_url | Direkte openbare prent-URL — dit moet net op die oomblik van die aanroep openbaar haalbaar wees. |
| languages, weights, glyph_types, model_tier | Dieselfde vorm en verstekwaardes as die REST-eindpunt — sien die API-oortjie se afdeling Skep lettertipe. |
Peil die bouvordering van 'n lettertipetaak. Sodra dit gereed is, gee dit die ttf-/otf-/woff-/woff2-lêer-URL's terug. Let wel: hulle is nie openbaar haalbaar nie (403) — gebruik die download_font-gereedskap om die grepe te kry.
| linkverpligtend | Die lettertipeskakel wat generate_font teruggegee het. |
Haal 'n lettertipelêer se grepe inlyn as 'n MCP-hulpbron, sodat jou agent dit reguit in jou projek op skyf kan skryf. Dit val terug op 'n gewone URL as die lêer buitengewoon groot is.
| linkverpligtend | Die lettertipeskakel wat generate_font teruggegee het. |
| format | ttf · otf · woff · woff2 — default ttf. |
Lys elke ondersteunde ISO-2-taalkode met glieftellings en teksrigting — gebruik dit om 'n geldige languages-skikking te bou.
Lys jou laaste 100 lettertipetake — status, model, bron en 'n skakel na elke lettertipe se bladsy.
MCP-gereedskap is net so goed soos die beskrywing daaragter. Hierdie lewer deurgaans sterk resultate:
"Skep 'n vriendelike, afgeronde sans-serif vir 'n kinderopvoedkundige toepassing, in Engels en Spaans, in normal- en bold-gewigte — stoor dan die ttf-lêers in ./public/fonts."
Dit noem die stemming, die tale, die gewigte en waar die resultaat moet beland — die agent kan die hele lus sonder toesig afhandel.
"Hier is 'n skermskoot van ons ou logo: https://example.com/logo.png — skep 'n vertoonlettertipe wat by die styl pas, ultra-gehalte, slegs Engels."
Verwysingsprente werk beter as byvoeglike naamwoorde om 'n spesifieke bestaande voorkoms na te maak — model_tier: ultra is die moeite werd vir vertoon- en opskriftipes.
"Kyk na die status van lettertipe 8WeheWlTl en sê vir my wanneer dit gereed is, gee my dan die woff2-URL."
'n Eenvoudige peil-en-rapporteer — goed om 'n taak na te gaan wat jy vroeër in die gesprek begin het.
"Watter Cirilliese en Griekse tale ondersteun YoFont? Ek het 'n lettertipe nodig wat Russies, Oekraïens en Grieks dek."
Laat die agent list_languages aanroep eerder as om ISO-kodes uit die geheue te raai — dit vermy 'n mislukte generate_font-aanroep oor 'n tikfout in 'n kode.
"Skep 'n geometriese vertoonlettertipe uit hierdie verwysingsprent, wag dat dit klaar is, laai dan die ttf af en voeg dit as 'n pasgemaakte font-face by ons Tailwind-konfigurasie."
Dit ryg al drie gereedskapstukke in een opdrag aanmekaar — skep → peil → aflaai — en gee die agent 'n konkrete volgende stap.
"Wys my al my lettertipes en sê vir my watter een nog in die tou is of misluk het."
Goed vir 'n statusoorsig oor 'n hele projek sonder om die paneel oop te maak.
Een versoek van jou kan die hele pyplyn afskop — jou agent hanteer die peilingslus, jy sien net die resultaat.