Genereer lettertypes, haal glyphs op en regel de levering programmatisch. Dezelfde engine als de app, één bearer-token verderop.
Alle verzoeken gebruiken een bearer-token in de Authorization-header. Houd hem server-side.
Log in om een live API-sleutel aan te maken — API- en MCP-toegang zit bij de Pro- en Studio-abonnementen inbegrepen.
Log in om je sleutel te krijgenVerzoeken worden per API-sleutel gelimiteerd. Boven de limiet krijg je 429 Too Many Requests met een Retry-After. De limieten schalen mee met je abonnement:
| Lettertype maken · al het andere | |
| Pro | 200 · 2 000 / min |
| Studio | 600 · 6 000 / min |
Meer doorvoer nodig? Upgrade je abonnement.
Genereer een complete lettertypefamilie uit een tekstprompt en/of een referentieafbeelding. Geeft een opdracht terug die je pollt tot hij klaar is.
| promptverplicht | Beschrijving van het lettertype in gewone taal. Optional when reference_image_url is set. |
| reference_image_url | Referentieafbeelding voor de stijl (PNG/JPG/WEBP) — een directe publieke URL. Wij slaan hem nooit op; we sturen de link ongewijzigd door naar de render-engine, net als de screenshot-naar-lettertype van de Figma- en Chrome-plugins. |
| languages | Array met ISO-codes — standaard ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | bijv. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Haal de status en download-URL's van een lettertype op (TTF / WOFF2 / variabel).
Download het gebouwde lettertypebestand in een specifiek formaat (ttf/otf/woff/woff2) — hetzelfde bestand dat de downloadknop in Studio geeft.
Elke ondersteunde ISO-2 taalcode, met glyph-aantallen per schrift en tekstrichting — gebruik dit om een geldige "languages"-array op te bouwen.
Je laatste 100 lettertype-opdrachten — status, model, bron en een link naar de pagina van elk lettertype.
Genereren is asynchroon. Poll na de POST naar generate GET /api/public/status?link=… elke paar seconden tot de status font_ready is (of failed).
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — hoeveel glyph-atlassen klaar zijn |
| fonts | URL's van de ttf/otf/woff/woff2-bestanden, aanwezig zodra status = font_ready. Voor deze URL's is je API-sleutel nodig — ze ophalen zonder Authorization-header geeft 403. Haal de bytes op via GET /api/public/download?link=…&format=…. |
Eens per 3–5 seconden pollen is ruim voldoende — een volledige familie is meestal binnen een paar minuten klaar. Haal de bestanden op via GET /api/public/download met je API-sleutel; de URL's in "fonts" zijn niet publiek toegankelijk.
Alle fouten volgen dezelfde JSON-vorm: { "success": false, "error": "…" }.
| 400 | Ongeldig verzoek — ontbrekende of ongeldige velden. Bekijk de error voor details. |
| 401 | Niet geautoriseerd — ontbrekende of ongeldige Authorization header. |
| 402 | Betaling vereist — je glyph-tegoed is op. Koop bij op de pagina Abonnementen. |
| 403 | Verboden — de link hoort bij een ander account. |
| 404 | Niet gevonden — de font-ID bestaat niet of hoort bij een ander account. |
| 429 | Te veel verzoeken — limiet bereikt. Probeer opnieuw na Retry-After. |
| 500 | Interne fout — er ging iets mis aan onze kant. Het na een paar seconden opnieuw proberen helpt meestal. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
Met MCP (Model Context Protocol) kunnen AI-codeeragents — Claude Code, Cursor, Codex en andere — YoFont direct aanroepen tijdens hun werk: midden in een gesprek een lettertype genereren, wachten tot het gebouwd is en het bestand meteen in je project zetten. Geen curl-commando's meer kopiëren en plakken.
Elke MCP-tool is een dunne, transparante laag over precies dezelfde REST-endpoints uit het tabblad API — dezelfde auth, dezelfde limieten, dezelfde validatie. Niets van wat de MCP-server doet blijft buiten de REST-documentatie.
Kopieer de prompt hieronder en plak hem in Claude Code, Cursor of Codex. Je agent registreert de YoFont MCP-server zelf en controleert hem — geen configbestanden om met de hand te bewerken.
Haal je sleutel op bij het onderdeel Authenticatie in het tabblad API.
Richt je MCP-client op https://yofont.com/api/public/mcp. Hij spreekt Streamable HTTP-transport (JSON-responsmodus) — één JSON-RPC 2.0-verzoek per aanroep, geen sessie of socket die open moet blijven.
| Transport | Streamable HTTP (JSON-RPC 2.0 over POST). Methodes: initialize, ping, tools/list, tools/call. |
| Auth | Dezelfde API-sleutel als bij de REST API — stuur hem als header bij elk verzoek: Authorization: Bearer yf_live_.... |
Vijf tools, één op één met de REST-endpoints uit het tabblad API — in MCP bestaat niets wat niet ook gewoon REST is.
Genereer een gloednieuwe lettertypefamilie uit een prompt en/of een referentieafbeelding. Geeft meteen een link terug om te pollen — dit is een asynchrone opdracht, geen blokkerende aanroep.
| prompt | Stijlbeschrijving in gewone taal. Optioneel als reference_image_url is meegegeven. |
| reference_image_url | Directe publieke afbeeldings-URL — hij hoeft op het moment van de aanroep alleen publiek opvraagbaar te zijn. |
| languages, weights, glyph_types, model_tier | Dezelfde vorm en standaardwaarden als bij het REST-endpoint — zie het onderdeel Lettertype maken in het tabblad API. |
Poll de bouwvoortgang van een lettertype-opdracht. Zodra hij klaar is, krijg je de URL's van de ttf/otf/woff/woff2-bestanden. Let op: die zijn niet publiek opvraagbaar (403) — gebruik de tool download_font om de bytes te krijgen.
| linkverplicht | De lettertypelink die generate_font teruggaf. |
Haal de bytes van een lettertypebestand inline op als MCP-resource, zodat je agent het direct in je project naar schijf kan schrijven. Valt terug op een gewone URL als het bestand ongebruikelijk groot is.
| linkverplicht | De lettertypelink die generate_font teruggaf. |
| format | ttf · otf · woff · woff2 — default ttf. |
Toon elke ondersteunde ISO-2 taalcode met glyph-aantallen en tekstrichting — gebruik dit om een geldige languages-array op te bouwen.
Toon je laatste 100 lettertype-opdrachten — status, model, bron en een link naar de pagina van elk lettertype.
MCP-tools zijn alleen zo goed als de prompt erachter. Deze geven steeds sterke resultaten:
"Genereer een vriendelijke, ronde schreefloze voor een educatieve kinder-app, in het Engels en Spaans, in normaal en bold — en sla de ttf-bestanden daarna op in ./public/fonts."
Noemt de sfeer, de talen, de gewichten en waar het resultaat heen moet — de agent kan de hele lus onbeheerd draaien.
"Hier is een screenshot van ons oude logo: https://example.com/logo.png — genereer een display-lettertype in die stijl, ultra kwaliteit, alleen Engels."
Referentieafbeeldingen werken beter dan bijvoeglijke naamwoorden om een bestaande look te treffen — model_tier: ultra is de moeite waard voor hero- en display-type.
"Check de status van lettertype 8WeheWlTl en zeg me wanneer het klaar is, geef me dan de woff2-URL."
Een simpele poll-en-rapporteer — handig om een opdracht te checken die je eerder in het gesprek startte.
"Welke Cyrillische en Griekse talen ondersteunt YoFont? Ik heb een lettertype nodig dat Russisch, Oekraïens en Grieks dekt."
Laat de agent list_languages aanroepen in plaats van ISO-codes uit het hoofd te gokken — dat voorkomt een mislukte generate_font-aanroep door een typefout in een code.
"Genereer een geometrisch display-lettertype op basis van deze referentieafbeelding, wacht tot het klaar is, download dan de ttf en voeg hem toe aan onze Tailwind-config als custom font-face."
Koppelt alle drie de tools in één instructie — genereren → pollen → downloaden — en geeft de agent een concrete volgende stap.
"Laat al mijn lettertypes zien en zeg me welke nog in de wachtrij staan of mislukt zijn."
Handig voor een statusronde over een heel project zonder het dashboard te openen.
Eén verzoek van jou kan de hele pijplijn starten — je agent doet de poll-lus, jij ziet alleen het resultaat.