Generează fonturi, preia glife și gestionează livrarea programatic. Același motor ca în aplicație, la distanță de un token bearer.
Toate cererile folosesc un token bearer în antetul Authorization. Păstrează-l pe server.
Autentifică-te ca să generezi o cheie API activă — accesul API și MCP este inclus în planurile Pro și Studio.
Autentifică-te ca să-ți primești cheiaCererile sunt limitate per cheie API. Depășirea limitei returnează 429 Too Many Requests cu un Retry-After. Limitele cresc odată cu planul tău:
| Creează font · tot restul | |
| Pro | 200 · 2 000 / min |
| Studio | 600 · 6 000 / min |
Ai nevoie de mai mult debit? Treci la un plan superior.
Generează o familie completă de fonturi pornind de la o descriere text și/sau o imagine de referință. Returnează o sarcină pe care o interoghezi până se finalizează.
| promptobligatoriu | Descrierea fontului în limbaj obișnuit. Optional when reference_image_url is set. |
| reference_image_url | Imagine de referință pentru stil (PNG/JPG/WEBP) — o adresă publică directă. Nu o stocăm niciodată; trimitem linkul ca atare către motorul de randare, la fel ca funcția captură-în-font din pluginurile Figma/Chrome. |
| languages | Array de coduri ISO — implicit ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | de exemplu ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Preia starea unui font și adresele de descărcare (TTF / WOFF2 / variabil).
Descarcă fișierul de font construit într-un format anume (ttf/otf/woff/woff2) — același fișier pe care îl produce butonul de descărcare din Studio.
Fiecare cod de limbă ISO-2 acceptat, cu numărul de glife per scriere și direcția textului — folosește-l ca să construiești un array „languages” valid.
Ultimele tale 100 de sarcini de font — stare, model, sursă și un link către pagina fiecărui font.
Generarea este asincronă. După ce trimiți POST la generate, interoghează GET /api/public/status?link=… la câteva secunde, până când starea devine font_ready (sau failed).
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — câte atlase de glife sunt gata |
| fonts | adresele fișierelor ttf/otf/woff/woff2, prezente odată ce status = font_ready. Aceste adrese necesită cheia ta API — accesarea lor fără antetul Authorization returnează 403. Descarcă conținutul prin GET /api/public/download?link=…&format=…. |
O interogare la 3–5 secunde este suficientă — o familie completă se termină de regulă în sub două minute. Preia fișierele prin GET /api/public/download cu cheia ta API; adresele din „fonts” nu sunt accesibile public.
Toate erorile au aceeași structură JSON: { "success": false, "error": "…" }.
| 400 | Cerere greșită — câmpuri lipsă sau invalide. Verifică error pentru detalii. |
| 401 | Neautorizat — lipsește sau este invalid Authorization antet. |
| 402 | Plată necesară — cota de glife este epuizată. Completeaz-o din pagina Planuri. |
| 403 | Interzis — linkul aparține altui cont. |
| 404 | Nu a fost găsit — ID-ul fontului nu există sau aparține altui cont. |
| 429 | Prea multe cereri — ai atins limita de cereri. Reîncearcă după Retry-After. |
| 500 | Eroare internă — ceva nu a mers bine la noi. De obicei o reîncercare după câteva secunde rezolvă problema. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) permite agenților AI de programare — Claude Code, Cursor, Codex și alții — să apeleze YoFont direct în timp ce lucrează: să genereze un font în mijlocul conversației, să aștepte construirea lui și să pună fișierul direct în proiectul tău. Fără copiere manuală de comenzi curl.
Fiecare apel de instrument MCP este un înveliș subțire și transparent peste aceleași endpointuri REST documentate în fila API — aceeași autentificare, aceleași limite, aceeași validare. Nimic din ce face serverul MCP nu este ascuns față de documentația REST.
Copiază instrucțiunea de mai jos și lipește-o în Claude Code, Cursor sau Codex. Agentul tău înregistrează singur serverul MCP YoFont și îl verifică — fără fișiere de configurare de editat manual.
Ia-ți cheia din secțiunea Autentificare de pe fila API.
Îndreaptă clientul tău MCP către https://yofont.com/api/public/mcp. Folosește transportul Streamable HTTP (mod răspuns JSON) — o cerere JSON-RPC 2.0 per apel, fără sesiune sau socket de ținut deschis.
| Transport | Streamable HTTP (JSON-RPC 2.0 prin POST). Metode: initialize, ping, tools/list, tools/call. |
| Autentificare | Aceeași cheie API ca la REST — trimite-o ca antet la fiecare cerere: Authorization: Bearer yf_live_.... |
Cinci instrumente, unu la unu cu endpointurile REST din fila API — nu există nimic în MCP care să nu fie și REST simplu.
Generează o familie de fonturi complet nouă dintr-o descriere și/sau o imagine de referință. Returnează imediat un link de interogat — este o sarcină asincronă, nu un apel blocant.
| prompt | Descrierea stilului în limbaj obișnuit. Opțională dacă este dat reference_image_url. |
| reference_image_url | Adresă publică directă către imagine — trebuie doar să poată fi accesată public în momentul apelului. |
| languages, weights, glyph_types, model_tier | Aceeași structură și aceleași valori implicite ca la endpointul REST — vezi secțiunea Creează font din fila API. |
Interoghează progresul construirii unei sarcini de font. Când este gata, returnează adresele fișierelor ttf/otf/woff/woff2. Atenție: acestea nu sunt accesibile public (403) — folosește instrumentul download_font ca să obții conținutul.
| linkobligatoriu | Linkul fontului returnat de generate_font. |
Preia conținutul unui fișier de font direct, ca resursă MCP, astfel încât agentul tău să îl poată scrie pe disc în proiect. Revine la o adresă simplă dacă fișierul este neobișnuit de mare.
| linkobligatoriu | Linkul fontului returnat de generate_font. |
| format | ttf · otf · woff · woff2 — default ttf. |
Listează fiecare cod de limbă ISO-2 acceptat, cu numărul de glife și direcția textului — folosește-l ca să construiești un array de limbi valid.
Listează ultimele tale 100 de sarcini de font — stare, model, sursă și un link către pagina fiecărui font.
Instrumentele MCP sunt doar atât de bune pe cât este instrucțiunea din spate. Acestea dau rezultate constant bune:
„Generează un sans-serif prietenos și rotunjit pentru o aplicație educativă pentru copii, în engleză și spaniolă, grosimi normal și bold — apoi salvează fișierele ttf în ./public/fonts.”
Numește atmosfera, limbile, grosimile și unde să pună rezultatul — agentul poate parcurge tot ciclul nesupravegheat.
„Iată o captură a vechiului nostru logo: https://example.com/logo.png — generează un font display care să-i imite stilul, calitate ultra, doar engleză.”
Imaginile de referință bat adjectivele când vrei să reproduci un aspect existent — model_tier: ultra merită pentru fonturile de titlu.
„Verifică starea fontului 8WeheWlTl și spune-mi când e gata, apoi dă-mi adresa woff2.”
O simplă interogare cu raportare — bună pentru a verifica o sarcină pornită mai devreme în conversație.
„Ce limbi chirilice și grecești acceptă YoFont? Am nevoie de un font care acoperă rusa, ucraineana și greaca.”
Lasă agentul să apeleze list_languages în loc să ghicească codurile ISO din memorie — eviți un apel generate_font eșuat din cauza unui cod scris greșit.
„Generează un font display geometric din această imagine de referință, așteaptă să se termine, apoi descarcă ttf-ul și adaugă-l în configul nostru Tailwind ca font-face personalizat.”
Înlănțuie toate cele trei instrumente într-o singură instrucțiune — generare → interogare → descărcare — și oferă agentului un pas următor concret.
„Arată-mi toate fonturile mele și spune-mi care mai sunt în așteptare sau au eșuat.”
Bună pentru o verificare rapidă a stării întregului proiect, fără să deschizi panoul de control.
O singură cerere din partea ta poate declanșa tot fluxul — agentul tău se ocupă de interogarea repetată, tu vezi doar rezultatul.