Entwickler · REST v1

YoFont API/MCP

Generiere Fonts, ruf Glyphen ab und steuere die Auslieferung programmatisch. Dieselbe Engine wie in der App — nur ein Bearer-Token entfernt.

// Authentifizierung

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.

// Ratenlimits

Die 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
Starter60 · 600 / Min
Pro200 · 2 000 / Min
Agency600 · 6 000 / Min

Brauchst du mehr Durchsatz? Tarif upgraden.

POST/api/public/generate

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.

prompterforderlichBeschreib die Schrift in ganz normaler Sprache. Optional when reference_image_url is set.
reference_image_urlReferenzbild 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.
languagesArray von ISO-Codes — Standard ist ["en"]. Two-letter ISO codes, full list: GET /api/public/languages.
weightsz. B. ["normal","bold","thin"].
glyph_typesletters · digits · punct · special (default all).
model_tierstandard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5).

                
200Angenommen — liefert { success, link, task_id, glyphs_charged, status_url }
// Response JSON

                
402Keine Glyphen mehr — lad auf der Tarifseite auf
GET/api/public/status?link=…

Ruft Status und Download-URLs eines Fonts ab (TTF / WOFF2 / variabel).

// Request

                
// Response JSON

                
GET/api/public/download?link=…

Lade die fertige Font-Datei in einem bestimmten Format herunter (ttf/otf/woff/woff2) — dieselbe Datei, die auch der Download-Button im Studio erzeugt.

// Request

                
// Response

                
GET/api/public/languages

Jeder unterstützte ISO-2-Sprachcode, mit Glyphenzahl je Schriftsystem und Textrichtung — damit baust du ein gültiges "languages"-Array.

// Request

                
// Response JSON

                
GET/api/public/fonts

Deine letzten 100 Font-Jobs — Status, Modell, Quelle und ein Link zur Seite jedes Fonts.

// Request

                
// Response JSON

                
// Abfragen

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.

statusqueued · processing · font_ready · failed
progress{ total, completed, failed } — wie viele Glyphen-Atlanten fertig sind
fontsDirekte 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.

// Fehler

Alle Fehler folgen derselben JSON-Struktur: { "success": false, "error": "…" }.

400Ungültige Anfrage — fehlende oder ungültige Felder. Prüf die error für Details.
401Nicht autorisiert — fehlender oder ungültiger Authorization Header.
402Zahlung erforderlich — Glyphen-Kontingent aufgebraucht. Lad auf der Tarifseite auf.
403Verboten — der Link gehört zu einem anderen Konto.
404Nicht gefunden — die Font-ID existiert nicht oder gehört zu einem anderen Konto.
429Zu viele Anfragen — Ratenlimit erreicht. Versuch es erneut nach Retry-After.
500Interner 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"
}