Generiere Fonts, ruf Glyphen ab und steuere die Auslieferung programmatisch. Dieselbe Engine wie in der App — nur ein Bearer-Token entfernt.
Jede Anfrage nutzt ein Bearer-Token im Authorization-Header. Halt ihn nur serverseitig.
Melde dich an, um einen aktiven API-Schlüssel zu erzeugen — kostenlos, jeder Tarif enthält API-Zugriff.
Anmelden und Schlüssel holenDie Limits gelten pro API-Schlüssel. Überschreitest du sie, kommt 429 Too Many Requests mit einem Retry-After. Die Limits skalieren mit deinem Tarif:
| Font erstellen · alles andere | |
| Starter | 60 · 600 / Min |
| Pro | 200 · 2 000 / Min |
| Agency | 600 · 6 000 / Min |
Brauchst du mehr Durchsatz? Tarif upgraden.
Generiere eine vollständige Schrift aus einem Text-Prompt und/oder einem Referenzbild. Du bekommst einen Job zurück, den du abfragst, bis er fertig ist.
| prompterforderlich | Beschreib die Schrift in ganz normaler Sprache. Optional when reference_image_url is set. |
| reference_image_url | Referenzbild für den Stil (PNG/JPG/WEBP) — eine direkte öffentliche URL. Wir speichern es nie; wir leiten den Link unverändert an die Render-Engine weiter, genau wie beim Screenshot-zu-Font der Figma-/Chrome-Plugins. |
| languages | Array von ISO-Codes — Standard ist ["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). |
Ruft Status und Download-URLs eines Fonts ab (TTF / WOFF2 / variabel).
Lade die fertige Font-Datei in einem bestimmten Format herunter (ttf/otf/woff/woff2) — dieselbe Datei, die auch der Download-Button im Studio erzeugt.
Jeder unterstützte ISO-2-Sprachcode, mit Glyphenzahl je Schriftsystem und Textrichtung — damit baust du ein gültiges "languages"-Array.
Deine letzten 100 Font-Jobs — Status, Modell, Quelle und ein Link zur Seite jedes Fonts.
Die Generierung läuft asynchron. Nach dem POST an generate, frag GET /api/public/status?link=… alle paar Sekunden ab, bis der Status font_ready (oder failed) ist.
| status | queued · processing · font_ready · failed |
| progress | { total, completed, failed } — wie viele Glyphen-Atlanten fertig sind |
| fonts | Direkte ttf/otf/woff/woff2-URLs, vorhanden sobald status = font_ready. |
Ein Poll alle 3–5 Sekunden reicht völlig — eine komplette Familie ist meist in unter zwei Minuten fertig. Die Font-Datei-URLs sind statisch und brauchen nach der Rückgabe keine Authentifizierung.
Alle Fehler folgen derselben JSON-Struktur: { "success": false, "error": "…" }.
| 400 | Ungültige Anfrage — fehlende oder ungültige Felder. Prüf die error für Details. |
| 401 | Nicht autorisiert — fehlender oder ungültiger Authorization Header. |
| 402 | Zahlung erforderlich — Glyphen-Kontingent aufgebraucht. Lad auf der Tarifseite auf. |
| 403 | Verboten — der Link gehört zu einem anderen Konto. |
| 404 | Nicht gefunden — die Font-ID existiert nicht oder gehört zu einem anderen Konto. |
| 429 | Zu viele Anfragen — Ratenlimit erreicht. Versuch es erneut nach Retry-After. |
| 500 | Interner Fehler — bei uns ist etwas schiefgelaufen. Ein erneuter Versuch nach ein paar Sekunden hilft meistens. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) lässt KI-Coding-Agenten — Claude Code, Cursor, Codex und andere — YoFont direkt während der Arbeit aufrufen: einen Font mitten im Gespräch generieren, auf die Fertigstellung warten und die Datei direkt ins Projekt legen. Kein Copy-Paste von curl-Befehlen.
Jeder MCP-Tool-Aufruf ist nur ein dünner, transparenter Wrapper um dieselben REST-Endpunkte, die im API-Tab dokumentiert sind — dieselbe Authentifizierung, dieselben Ratenlimits, dieselbe Validierung. Der MCP-Server tut nichts, was nicht auch in den REST-Docs steht.
Kopier den Prompt unten und füg ihn in Claude Code, Cursor oder Codex ein. Dein Agent registriert den YoFont-MCP-Server selbst und prüft ihn — keine Config-Dateien von Hand bearbeiten.
Hol dir deinen Schlüssel im Abschnitt Authentifizierung auf dem API-Tab.
Richte deinen MCP-Client auf https://yofont.com/api/public/mcp. Er spricht Streamable-HTTP-Transport (JSON-Antwortmodus) — ein JSON-RPC-2.0-Request pro Aufruf, keine Session oder Socket, die offen bleiben muss.
| Transport | Streamable HTTP (JSON-RPC 2.0 über POST). Methoden: initialize, ping, tools/list, tools/call. |
| Authentifizierung | Derselbe API-Schlüssel wie bei der REST-API — sende ihn als Header bei jeder Anfrage: Authorization: Bearer yf_live_.... |
Fünf Tools, eins zu eins den REST-Endpunkten im API-Tab entsprechend — in MCP gibt es nichts, was nicht auch als einfaches REST existiert.
Generiert eine komplett neue Font-Familie aus einem Prompt und/oder einem Referenzbild. Liefert sofort einen Link zum Abfragen zurück — das ist ein asynchroner Job, kein blockierender Aufruf.
| prompt | Stilbeschreibung in normaler Sprache. Optional, wenn reference_image_url angegeben ist. |
| reference_image_url | Direkte öffentliche Bild-URL — muss zum Zeitpunkt des Aufrufs nur öffentlich abrufbar sein. |
| languages, weights, glyph_types, model_tier | Gleiche Struktur und Standardwerte wie beim REST-Endpunkt — siehe den Abschnitt "Font erstellen" im API-Tab. |
Fragt den Baufortschritt eines Font-Jobs ab. Sobald er fertig ist, liefert er direkte ttf/otf/woff/woff2-URLs — die kannst du direkt abrufen, ohne Authentifizierung.
| linkerforderlich | Der Font-Link, den generate_font zurückgegeben hat. |
Holt die Bytes einer Font-Datei direkt als MCP-Ressource, damit dein Agent sie sofort auf die Festplatte in dein Projekt schreiben kann. Fällt bei ungewöhnlich großen Dateien auf eine einfache URL zurück.
| linkerforderlich | Der Font-Link, den generate_font zurückgegeben hat. |
| format | ttf · otf · woff · woff2 — default ttf. |
Listet jeden unterstützten ISO-2-Sprachcode mit Glyphenzahl und Textrichtung auf — damit baust du ein gültiges languages-Array.
Listet deine letzten 100 Font-Jobs auf — Status, Modell, Quelle und ein Link zur Seite jedes Fonts.
MCP-Tools sind nur so gut wie der Prompt dahinter. Diese hier liefern zuverlässig starke Ergebnisse:
"Generier einen freundlichen, abgerundeten Grotesk-Font für eine Lern-App für Kinder, auf Englisch und Spanisch, in normal und bold — und speicher die ttf-Dateien in ./public/fonts."
Nennt Stimmung, Sprachen, Schnitte und wohin das Ergebnis soll — der Agent kann den ganzen Ablauf unbeaufsichtigt durchlaufen.
"Hier ist ein Screenshot unseres alten Logos: https://example.com/logo.png — generier einen Display-Font, der zu diesem Stil passt, Qualität ultra, nur Englisch."
Referenzbilder treffen einen bestimmten bestehenden Look genauer als Adjektive — model_tier: ultra lohnt sich für Hero-/Display-Schriften.
"Prüf den Status von Font 8WeheWlTl und sag mir Bescheid, wenn er fertig ist, dann gib mir die woff2-URL."
Ein einfaches Abfragen-und-Melden — praktisch, um einen Job zu checken, den du weiter oben im Gespräch gestartet hast.
"Welche kyrillischen und griechischen Sprachen unterstützt YoFont? Ich brauche einen Font, der Russisch, Ukrainisch und Griechisch abdeckt."
Lass den Agenten list_languages aufrufen, statt ISO-Codes aus dem Gedächtnis zu raten — das verhindert einen fehlgeschlagenen generate_font-Aufruf wegen eines Tippfehlers im Code.
"Generier einen geometrischen Display-Font aus diesem Referenzbild, warte, bis er fertig ist, lad dann die ttf herunter und füg sie als benutzerdefinierte font-face zu unserer Tailwind-Konfiguration hinzu."
Verkettet alle drei Tools in einer Anweisung — generieren → abfragen → herunterladen — und gibt dem Agenten einen konkreten nächsten Schritt.
"Zeig mir alle meine Fonts und sag mir, welche noch in der Warteschlange sind oder fehlgeschlagen sind."
Praktisch für einen Statusüberblick über ein ganzes Projekt, ohne das Dashboard zu öffnen.
Eine einzige Anfrage von dir kann die gesamte Pipeline auslösen — dein Agent übernimmt die Abfrageschleife, du siehst nur das Ergebnis.