Пријава
Пријава
Genera font, recupera glifi e gestisci la consegna direttamente da codice. Lo stesso motore dell'app: ti basta un bearer token.
Tutte le richieste usano un bearer token nell'header Authorization. Mantienilo lato server.
Accedi per generare una chiave API attiva — è gratis, ogni piano include l'accesso API.
Accedi per ottenere la tua chiaveLe richieste sono limitate per chiave API. Superare il limite restituisce 429 Too Many Requests con un Retry-After. I limiti crescono con il piano:
| Crea font · tutto il resto | |
| Starter | 60 · 600 / min |
| Pro | 200 · 2 000 / min |
| Agency | 600 · 6 000 / min |
Ti serve più throughput? Passa a un piano superiore.
Genera una famiglia di font completa da un prompt testuale. Restituisce un job che puoi interrogare o ricevere tramite webhook.
| promptobbligatorio | Descrizione del font in linguaggio naturale. Optional when reference_image_url is set. |
| reference_image_url | Immagine di riferimento per lo stile (PNG/JPG/WEBP) — un URL pubblico diretto. Non la conserviamo mai; inoltriamo il link così com'è al motore di rendering, come fanno i plugin Figma/Chrome per la generazione da screenshot. |
| languages | Array di codici ISO — valore predefinito: ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | es. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Recupera lo stato di un font e gli URL di download (TTF / WOFF2 / variabile).
Scarica il file del font compilato in un formato specifico (ttf/otf/woff/woff2) — lo stesso file prodotto dal pulsante di download di Studio.
Ogni codice lingua ISO-2 supportato, con il conteggio dei glifi per ogni sistema di scrittura e la direzione del testo — usalo per costruire un array "languages" valido.
Le tue ultime 100 richieste di font — stato, modello, origine e link alla pagina di ciascun font.
La generazione è asincrona. Dopo il POST a generate, interroga GET /api/public/status?link=… ogni pochi secondi finché lo stato non diventa font_ready (o failed).
| status | queued · processing · font_ready · failed |
| progress | { total, completed, failed } — quanti atlanti di glifi sono completati |
| fonts | URL diretti ttf/otf/woff/woff2, presenti quando status = font_ready. |
Un poll ogni 3–5 secondi è più che sufficiente — una famiglia completa in genere finisce in meno di un paio di minuti. Gli URL dei file dei font sono statici e non richiedono autenticazione una volta restituiti.
Tutti gli errori seguono una struttura JSON coerente: { "success": false, "error": "…" }.
| 400 | Richiesta non valida — campi mancanti o non validi. Controlla l'error per i dettagli. |
| 401 | Non autorizzato — token mancante o non valido nell'header Authorization header. |
| 402 | Pagamento richiesto — quota di glifi esaurita. Ricarica nella pagina Piani. |
| 403 | Vietato — il link appartiene a un altro account. |
| 404 | Non trovato — l'ID del font non esiste o appartiene a un altro account. |
| 429 | Troppe richieste — limite di frequenza raggiunto. Riprova dopo Retry-After. |
| 500 | Errore interno — qualcosa è andato storto da parte nostra. Di solito basta riprovare dopo qualche secondo. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) permette agli agenti di coding AI — Claude Code, Cursor, Codex e altri — di chiamare YoFont direttamente mentre lavorano: generare un font a metà conversazione, aspettare che venga compilato e inserire il file dritto nel tuo progetto. Niente comandi curl da copiare e incollare.
Ogni chiamata a uno strumento MCP è un wrapper sottile e trasparente sugli stessi endpoint REST documentati nella scheda API — stessa autenticazione, stessi limiti di frequenza, stessa validazione. Nulla di ciò che fa il server MCP è nascosto rispetto alla documentazione REST.
Copia il prompt qui sotto e incollalo in Claude Code, Cursor o Codex. Il tuo agente registra da solo il server MCP di YoFont e lo verifica — nessun file di configurazione da modificare a mano.
Ottieni la tua chiave nella sezione Autenticazione della scheda API.
Punta il tuo client MCP verso https://yofont.com/api/public/mcp. Usa il trasporto Streamable HTTP (modalità risposta JSON) — una richiesta JSON-RPC 2.0 per chiamata, nessuna sessione o socket da tenere aperti.
| Trasporto | Streamable HTTP (JSON-RPC 2.0 su POST). Metodi: initialize, ping, tools/list, tools/call. |
| Autenticazione | Stessa chiave API del REST — inviala come header in ogni richiesta: Authorization: Bearer yf_live_.... |
Cinque strumenti, uno a uno con gli endpoint REST della scheda API — niente in MCP che non esista anche come REST puro.
Genera una nuova famiglia di font da un prompt e/o un'immagine di riferimento. Restituisce subito un link da interrogare — è un job asincrono, non una chiamata bloccante.
| prompt | Descrizione dello stile in linguaggio naturale. Facoltativo se viene fornito reference_image_url. |
| reference_image_url | URL pubblico diretto dell'immagine — deve solo essere raggiungibile pubblicamente al momento della chiamata. |
| languages, weights, glyph_types, model_tier | Stessa struttura e stessi valori predefiniti dell'endpoint REST — vedi la sezione Crea font nella scheda API. |
Interroga l'avanzamento della compilazione di un font. Una volta pronto, restituisce URL diretti per ttf/otf/woff/woff2 — nessuna autenticazione richiesta per scaricarli.
| linkobbligatorio | Il link del font restituito da generate_font. |
Recupera i byte di un file di font in linea come risorsa MCP, così il tuo agente può scriverlo direttamente su disco nel tuo progetto. Ricade su un URL semplice se il file è insolitamente grande.
| linkobbligatorio | Il link del font restituito da generate_font. |
| format | ttf · otf · woff · woff2 — default ttf. |
Elenca ogni codice lingua ISO-2 supportato con conteggio dei glifi e direzione del testo — usalo per costruire un array languages valido.
Le tue ultime 100 richieste di font — stato, modello, origine e link alla pagina di ciascun font.
Gli strumenti MCP valgono quanto il prompt dietro di loro. Questi danno risultati costantemente solidi:
"Genera un sans-serif amichevole e arrotondato per un'app educativa per bambini, in inglese e spagnolo, pesi normal e bold — poi salva i file ttf in ./public/fonts."
Specifica il tono, le lingue, i pesi e dove salvare il risultato — l'agente può portare a termine l'intero ciclo senza supervisione.
"Ecco uno screenshot del nostro vecchio logo: https://example.com/logo.png — genera un font display che ne ricalchi lo stile, qualità ultra, solo inglese."
Un'immagine di riferimento batte gli aggettivi quando si tratta di ricalcare uno stile esistente preciso — model_tier: ultra vale la pena per un font display/hero.
"Controlla lo stato del font 8WeheWlTl e avvisami quando è pronto, poi dammi l'URL woff2."
Un semplice controlla-e-riferisci — utile per seguire un job avviato in precedenza nella conversazione.
"Quali lingue cirilliche e greche supporta YoFont? Mi serve un font che copra russo, ucraino e greco."
Lascia che l'agente chiami list_languages invece di indovinare i codici ISO a memoria — evita una generate_font fallita per un codice sbagliato.
"Genera un font display geometrico da questa immagine di riferimento, aspetta che finisca, poi scarica il ttf e aggiungilo alla nostra configurazione Tailwind come font-face personalizzato."
Concatena tutti e tre gli strumenti in un'unica istruzione — genera → interroga → scarica — e lascia all'agente un passo successivo concreto.
"Mostrami tutti i miei font e dimmi quali sono ancora in coda o falliti."
Utile per un controllo di stato su tutto il progetto senza aprire la dashboard.
Una tua richiesta può innescare l'intera pipeline — il tuo agente gestisce il ciclo di polling, tu vedi solo il risultato.