Generera teckensnitt, hämta glyfer och sköt leveransen programmatiskt. Samma motor som i appen, en bearer-token bort.
Alla anrop använder en bearer-token i huvudet Authorization. Håll den på serversidan.
Logga in för att skapa en riktig API-nyckel — API- och MCP-åtkomst ingår i planerna Pro och Studio.
Logga in för att hämta din nyckelAnropen begränsas per API-nyckel. Överskrids gränsen returneras 429 Too Many Requests med en Retry-After. Gränserna skalar med din plan:
| Skapa teckensnitt · allt annat | |
| Pro | 200 · 2 000 / min |
| Studio | 600 · 6 000 / min |
Behöver du mer kapacitet? Uppgradera din plan.
Generera en komplett teckensnittsfamilj från en textprompt och/eller en referensbild. Returnerar ett jobb som du pollar tills det är klart.
| promptobligatoriskt | Beskrivning av typsnittet på vanligt språk. Optional when reference_image_url is set. |
| reference_image_url | Stilreferensbild (PNG/JPG/WEBP) — en direkt publik URL. Vi lagrar den aldrig; vi skickar länken vidare som den är till renderingsmotorn, precis som skärmbild-till-teckensnitt i plugin-programmen för Figma/Chrome. |
| languages | Array med ISO-koder — standardvärde ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | t.ex. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Hämta ett teckensnitts status och nedladdningslänkar (TTF / WOFF2 / variabel).
Ladda ner den byggda teckensnittsfilen i ett visst format (ttf/otf/woff/woff2) — samma fil som nedladdningsknappen i Studio ger.
Alla ISO-2-språkkoder som stöds, med glyfantal per skriftsystem och textriktning — använd den för att bygga en giltig "languages"-array.
Dina 100 senaste teckensnittsjobb — status, modell, källa och en länk till varje teckensnitts sida.
Genereringen är asynkron. Efter POST till generate, polla GET /api/public/status?link=… med några sekunders mellanrum tills statusen är font_ready (eller failed).
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — hur många glyfatlaser som är klara |
| fonts | fil-URL:er för ttf/otf/woff/woff2, finns så snart status = font_ready. De här URL:erna kräver din API-nyckel — hämtar du dem utan Authorization-huvudet får du 403. Ladda ner filen via GET /api/public/download?link=…&format=…. |
En pollning var tredje till femte sekund räcker gott — en hel familj blir vanligtvis klar på under ett par minuter. Hämta filerna via GET /api/public/download med din API-nyckel; URL:erna i "fonts" är inte publikt åtkomliga.
Alla fel följer samma JSON-form: { "success": false, "error": "…" }.
| 400 | Felaktigt anrop — fält saknas eller är ogiltiga. Kontrollera error för detaljer. |
| 401 | Ej behörig — saknad eller ogiltig Authorization huvudet. |
| 402 | Betalning krävs — glyfkvoten är slut. Fyll på under Planer. |
| 403 | Åtkomst nekad — länken tillhör ett annat konto. |
| 404 | Hittades inte — teckensnitts-ID:t finns inte eller tillhör ett annat konto. |
| 429 | För många anrop — hastighetsgränsen nådd. Försök igen efter Retry-After. |
| 500 | Internt fel — något gick fel hos oss. Ett nytt försök efter några sekunder brukar fungera. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) låter AI-kodagenter — Claude Code, Cursor, Codex och andra — anropa YoFont direkt medan de arbetar: generera ett teckensnitt mitt i samtalet, vänta på att det byggs och lägga filen rakt in i ditt projekt. Inga curl-kommandon att kopiera.
Varje MCP-verktygsanrop är ett tunt, genomskinligt skal runt samma REST-endpoints som dokumenteras under API-fliken — samma autentisering, samma hastighetsgränser, samma validering. Ingenting MCP-servern gör är dolt från REST-dokumentationen.
Kopiera prompten nedan och klistra in den i Claude Code, Cursor eller Codex. Din agent registrerar YoFonts MCP-server själv och verifierar den — inga konfigurationsfiler att redigera för hand.
Hämta din nyckel i avsnittet Autentisering under API-fliken.
Peka din MCP-klient mot https://yofont.com/api/public/mcp. Den talar Streamable HTTP-transport (JSON-svarsläge) — ett JSON-RPC 2.0-anrop per gång, ingen session eller socket att hålla öppen.
| Transport | Streamable HTTP (JSON-RPC 2.0 över POST). Metoder: initialize, ping, tools/list, tools/call. |
| Autentisering | Samma API-nyckel som REST-API:t — skicka den som ett huvud i varje anrop: Authorization: Bearer yf_live_.... |
Fem verktyg, ett till ett med REST-endpointerna under API-fliken — det finns inget i MCP som inte också är vanlig REST.
Generera en helt ny teckensnittsfamilj från en prompt och/eller en referensbild. Svarar direkt med en länk att polla — det här är ett asynkront jobb, inte ett blockerande anrop.
| prompt | Stilbeskrivning på vanligt språk. Valfritt om reference_image_url anges. |
| reference_image_url | Direkt publik bild-URL — den behöver bara gå att hämta publikt vid anropet. |
| languages, weights, glyph_types, model_tier | Samma form och standardvärden som REST-endpointen — se avsnittet Skapa teckensnitt under API-fliken. |
Polla byggförloppet för ett teckensnittsjobb. När det är klart returneras fil-URL:erna för ttf/otf/woff/woff2. Obs: de går inte att hämta publikt (403) — använd verktyget download_font för att få filen.
| linkobligatoriskt | Teckensnittslänken som generate_font returnerade. |
Hämta en teckensnittsfil inline som en MCP-resurs, så att din agent kan skriva den direkt till disk i ditt projekt. Faller tillbaka på en vanlig URL om filen är ovanligt stor.
| linkobligatoriskt | Teckensnittslänken som generate_font returnerade. |
| format | ttf · otf · woff · woff2 — default ttf. |
Lista alla ISO-2-språkkoder som stöds, med glyfantal och textriktning — använd den för att bygga en giltig languages-array.
Lista dina 100 senaste teckensnittsjobb — status, modell, källa och en länk till varje teckensnitts sida.
MCP-verktyg är bara så bra som prompten bakom dem. De här ger genomgående starka resultat:
"Generera en vänlig, rundad sans-serif för en utbildningsapp för barn, på engelska och spanska, i vikterna normal och bold — spara sedan ttf-filerna i ./public/fonts."
Anger stämning, språk, vikter och var resultatet ska hamna — agenten kan köra hela loopen på egen hand.
"Här är en skärmbild av vår gamla logotyp: https://example.com/logo.png — generera ett display-teckensnitt som matchar stilen, ultrakvalitet, bara engelska."
Referensbilder slår adjektiv när ett specifikt befintligt utseende ska matchas — model_tier: ultra är värt det för rubrik- och display-typografi.
"Kolla statusen för teckensnittet 8WeheWlTl och säg till när det är klart, ge mig sedan woff2-länken."
En enkel polla-och-rapportera — bra för att kolla upp ett jobb du startade tidigare i samtalet.
"Vilka kyrilliska och grekiska språk stöder YoFont? Jag behöver ett teckensnitt som täcker ryska, ukrainska och grekiska."
Låt agenten anropa list_languages i stället för att gissa ISO-koder ur minnet — det slipper ett misslyckat generate_font på grund av en felstavad kod.
"Generera ett geometriskt display-teckensnitt från den här referensbilden, vänta tills det är klart, ladda sedan ner ttf-filen och lägg in den i vår Tailwind-konfiguration som ett eget font-face."
Kedjar ihop alla tre verktygen i en instruktion — generera → polla → ladda ner — och ger agenten ett konkret nästa steg.
"Visa alla mina teckensnitt och säg vilka som fortfarande står i kö eller har misslyckats."
Bra för en statusgenomgång av ett helt projekt utan att öppna kontrollpanelen.
Ett anrop från dig kan dra igång hela kedjan — din agent sköter poll-loopen, du ser bara resultatet.