Generer fonter, hent glyffer og styr levering programmatisk. Samme motor som i appen, ett bearer-token unna.
Alle forespørsler bruker et bearer-token i Authorization-headeren. Hold det på serversiden.
Logg inn for å lage en aktiv API-nøkkel — tilgang til API og MCP følger med planene Pro og Studio.
Logg inn for å hente nøkkelen dinForespørsler begrenses per API-nøkkel. Over grensen får du 429 Too Many Requests med en Retry-After. Grensene følger planen din:
| Lag font · alt annet | |
| Pro | 200 · 2 000 / min |
| Studio | 600 · 6 000 / min |
Trenger du mer kapasitet? Oppgrader planen din.
Generer en komplett fontfamilie fra en tekstprompt og/eller et referansebilde. Returnerer en jobb du spør om status på til den er ferdig.
| promptpåkrevd | Beskrivelse av skrifttypen på vanlig språk. Optional when reference_image_url is set. |
| reference_image_url | Referansebilde for stilen (PNG/JPG/WEBP) — en direkte, offentlig adresse. Vi lagrer det aldri; vi sender lenken videre som den er til rendringsmotoren, på samme måte som skjermbilde-til-font i Figma- og Chrome-tilleggene. |
| languages | Array med ISO-koder — som standard ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | f.eks. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Hent statusen til en font og nedlastingsadressene (TTF / WOFF2 / variabel).
Last ned den ferdige fontfilen i et bestemt format (ttf/otf/woff/woff2) — samme fil som nedlastingsknappen i Studio gir deg.
Alle støttede ISO-2-språkkoder, med glyffantall per skriftsystem og tekstretning — bruk det til å bygge et gyldig «languages»-array.
De siste 100 fontjobbene dine — status, modell, kilde og en lenke til hver fontside.
Genereringen er asynkron. Etter POST til generate, sjekk GET /api/public/status?link=… med noen sekunders mellomrom til statusen er font_ready (eller failed).
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — hvor mange glyffatlas som er ferdige |
| fonts | adresser til ttf/otf/woff/woff2-filene, til stede så snart status = font_ready. Disse adressene krever API-nøkkelen din — henter du dem uten Authorization-headeren, får du 403. Last ned filene gjennom GET /api/public/download?link=…&format=…. |
Én sjekk hvert 3.–5. sekund holder i massevis — en hel familie er som regel ferdig på under et par minutter. Hent filene med GET /api/public/download og API-nøkkelen din; adressene i «fonts» er ikke offentlig tilgjengelige.
Alle feil følger samme JSON-form: { "success": false, "error": "…" }.
| 400 | Ugyldig forespørsel — felt mangler eller er ugyldige. Sjekk error for detaljer. |
| 401 | Ikke autorisert — mangler eller har ugyldig Authorization -headeren. |
| 402 | Betaling kreves — glyffkvoten er brukt opp. Fyll på under Planer. |
| 403 | Ingen tilgang — lenken tilhører en annen konto. |
| 404 | Ikke funnet — font-ID-en finnes ikke eller tilhører en annen konto. |
| 429 | For mange forespørsler — fartsgrensen er nådd. Prøv igjen etter Retry-After. |
| 500 | Intern feil — noe gikk galt hos oss. Et nytt forsøk etter noen sekunder pleier å løse det. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) lar AI-kodeagenter — Claude Code, Cursor, Codex og andre — kalle YoFont direkte mens de jobber: generere en font midt i samtalen, vente til den er bygget og legge filen rett inn i prosjektet ditt. Ingen curl-kommandoer å kopiere.
Hvert MCP-verktøykall er et tynt, gjennomsiktig lag over de samme REST-endepunktene som er dokumentert under API-fanen — samme autentisering, samme fartsgrenser, samme validering. MCP-serveren gjør ingenting som ikke står i REST-dokumentasjonen.
Kopier prompten under og lim den inn i Claude Code, Cursor eller Codex. Agenten registrerer YoFont MCP-serveren selv og verifiserer den — ingen konfigurasjonsfiler å redigere for hånd.
Hent nøkkelen din fra avsnittet om autentisering under API-fanen.
Pek MCP-klienten din mot https://yofont.com/api/public/mcp. Den snakker Streamable HTTP-transport (JSON-svarmodus) — én JSON-RPC 2.0-forespørsel per kall, ingen økt eller socket som må holdes åpen.
| Transport | Streamable HTTP (JSON-RPC 2.0 over POST). Metoder: initialize, ping, tools/list, tools/call. |
| Autentisering | Samme API-nøkkel som i REST-API-et — send den som en header på hver forespørsel: Authorization: Bearer yf_live_.... |
Fem verktøy, én-til-én med REST-endepunktene under API-fanen — ingenting finnes i MCP som ikke også er vanlig REST.
Generer en helt ny fontfamilie fra en prompt og/eller et referansebilde. Svarer med én gang, med en lenke å sjekke status på — dette er en asynkron jobb, ikke et blokkerende kall.
| prompt | Stilbeskrivelse på vanlig språk. Valgfri hvis reference_image_url er oppgitt. |
| reference_image_url | Direkte, offentlig bildeadresse — den må bare være offentlig tilgjengelig i det kallet skjer. |
| languages, weights, glyph_types, model_tier | Samme form og standardverdier som REST-endepunktet — se avsnittet «Lag font» under API-fanen. |
Sjekk byggeframdriften til en fontjobb. Når den er klar, returneres adressene til ttf/otf/woff/woff2-filene. Merk: de er ikke offentlig tilgjengelige (403) — bruk verktøyet download_font for å hente selve filen.
| linkpåkrevd | Fontlenken som generate_font returnerte. |
Hent innholdet i en fontfil direkte som en MCP-ressurs, slik at agenten din kan skrive den rett til disk i prosjektet ditt. Faller tilbake til en vanlig adresse hvis filen er uvanlig stor.
| linkpåkrevd | Fontlenken som generate_font returnerte. |
| format | ttf · otf · woff · woff2 — default ttf. |
List opp alle støttede ISO-2-språkkoder med glyffantall og tekstretning — bruk det til å bygge et gyldig languages-array.
List opp de siste 100 fontjobbene dine — status, modell, kilde og en lenke til hver fontside.
MCP-verktøy er ikke bedre enn prompten bak dem. Disse gir jevnt gode resultater:
«Generer en vennlig, avrundet grotesk til en læringsapp for barn, på engelsk og spansk, i vektene normal og bold — og lagre så ttf-filene i ./public/fonts.»
Sier hva stemningen er, hvilke språk, hvilke vekter og hvor resultatet skal — agenten kan kjøre hele løpet uten tilsyn.
«Her er et skjermbilde av den gamle logoen vår: https://example.com/logo.png — generer en display-font som matcher stilen, ultra-kvalitet, kun engelsk.»
Referansebilder slår adjektiver når du skal treffe et bestemt eksisterende uttrykk — model_tier: ultra er verdt det for display- og overskriftsfonter.
«Sjekk statusen på font 8WeheWlTl og si fra når den er klar, og gi meg så woff2-adressen.»
En enkel sjekk-og-rapporter — fin for å følge opp en jobb du startet tidligere i samtalen.
«Hvilke kyrilliske og greske språk støtter YoFont? Jeg trenger en font som dekker russisk, ukrainsk og gresk.»
La agenten kalle list_languages i stedet for å gjette ISO-koder fra hukommelsen — det hindrer at generate_font feiler på en feilskrevet kode.
«Generer en geometrisk display-font fra dette referansebildet, vent til den er ferdig, last så ned ttf-filen og legg den inn i Tailwind-konfigurasjonen vår som en egen font-face.»
Kjeder alle tre verktøyene i én instruksjon — generer → sjekk status → last ned — og gir agenten et konkret neste steg.
«Vis meg alle fontene mine og si hvilke som fortsatt står i kø eller har feilet.»
Fin for en rask statussjekk over et helt prosjekt uten å åpne dashbordet.
Én forespørsel fra deg kan sette i gang hele løpet — agenten din tar seg av statussjekkene, du ser bare resultatet.