Genereeri fonte, hangi glüüfe ja halda tarnet programselt. Sama mootor mis rakenduses, ühe bearer-tokeni kaugusel.
Kõik päringud kasutavad bearer-tokenit päises Authorization. Hoia seda serveri poolel.
Logi sisse, et luua töötav API-võti — API ja MCP ligipääs kuulub Pro ja Studio pakettide juurde.
Võtme saamiseks logi sissePäringuid piiratakse API-võtme kaupa. Limiidi ületamisel tagastatakse 429 Too Many Requests koos päisega Retry-After. Limiidid kasvavad koos paketiga:
| Loo font · kõik muu | |
| Pro | 200 · 2 000 / min |
| Studio | 600 · 6 000 / min |
Vajad suuremat läbilaskevõimet? Uuenda oma paketti.
Genereeri tekstikirjelduse ja/või näidispildi põhjal terviklik fondiperekond. Tagastab töö, mille valmimist pärid.
| promptkohustuslik | Kirjatüübi kirjeldus tavalises keeles. Optional when reference_image_url is set. |
| reference_image_url | Stiilinäidise pilt (PNG/JPG/WEBP) — otsene avalik link. Me ei salvesta seda kunagi; edastame lingi muutmata kujul renderdusmootorile, täpselt nagu Figma/Chrome'i pluginate ekraanipildist-fondiks. |
| languages | ISO-koodide massiiv — vaikimisi ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | nt ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Hangi fondi olek ja allalaadimislingid (TTF / WOFF2 / muutuvfont).
Laadi valmis fondifail alla kindlas formaadis (ttf/otf/woff/woff2) — sama fail, mille annab Studio allalaadimisnupp.
Kõik toetatud ISO-2 keelekoodid koos glüüfide arvu ja teksti suunaga iga kirjasüsteemi kohta — kasuta seda kehtiva massiivi "languages" koostamiseks.
Sinu viimased 100 fonditööd — olek, mudel, allikas ja link iga fondi lehele.
Genereerimine on asünkroonne. Pärast POST-i aadressile generate päri GET /api/public/status?link=… iga paari sekundi tagant, kuni olek on font_ready (või failed).
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — mitu glüüfiatlast on valmis |
| fonts | ttf/otf/woff/woff2 failide lingid, olemas siis, kui status = font_ready. Need lingid nõuavad sinu API-võtit — ilma Authorization-päiseta pärides tuleb 403. Laadi baidid alla siit: GET /api/public/download?link=…&format=…. |
Üks päring iga 3–5 sekundi tagant on täiesti piisav — terve perekond saab tavaliselt paari minutiga valmis. Hangi failid päringuga GET /api/public/download koos oma API-võtmega; väljal "fonts" olevad lingid pole avalikult kättesaadavad.
Kõik vead järgivad ühtset JSON-kuju: { "success": false, "error": "…" }.
| 400 | Vigane päring — puuduvad või vigased väljad. Kontrolli error üksikasjade jaoks. |
| 401 | Autoriseerimata — puudub või on vigane Authorization päises. |
| 402 | Nõutav makse — glüüfikvoot on otsas. Täienda pakettide lehel. |
| 403 | Keelatud — link kuulub teisele kontole. |
| 404 | Ei leitud — sellist fondi ID-d pole või see kuulub teisele kontole. |
| 429 | Liiga palju päringuid — päringulimiit sai täis. Proovi uuesti pärast Retry-After. |
| 500 | Sisemine viga — midagi läks meie poolel valesti. Mõne sekundi pärast uuesti proovimine tavaliselt aitab. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) lubab AI-kodeerimisagentidel — Claude Code, Cursor, Codex ja teised — kutsuda YoFonti töö käigus otse välja: genereerida font keset vestlust, oodata selle valmimist ja panna fail kohe sinu projekti. Pole vaja curl-käske kopeerida.
Iga MCP tööriistakutse on õhuke ja läbipaistev kate samadele REST-lõpp-punktidele, mis on dokumenteeritud API vahelehel — sama autentimine, samad limiidid, sama valideerimine. MCP-server ei tee midagi, mis oleks REST-dokumentatsiooni eest varjatud.
Kopeeri allolev kirjeldus ja kleebi see Claude Code'i, Cursorisse või Codexisse. Agent registreerib YoFonti MCP-serveri ise ja kontrollib seda üle — käsitsi muudetavaid seadistusfaile pole.
Võtme leiad API vahelehe autentimise jaotisest.
Suuna oma MCP-klient aadressile https://yofont.com/api/public/mcp. See kasutab Streamable HTTP transporti (JSON-vastuse režiim) — üks JSON-RPC 2.0 päring kutse kohta, pole vaja hoida avatud seanssi ega soklit.
| Transport | Streamable HTTP (JSON-RPC 2.0 üle POST-i). Meetodid: initialize, ping, tools/list, tools/call. |
| Autentimine | Sama API-võti mis REST API-l — saada see iga päringuga päises: Authorization: Bearer yf_live_.... |
Viis tööriista, üks ühele API vahelehe REST-lõpp-punktidega — MCP-s pole midagi, mida poleks ka tavalises RESTis.
Genereeri kirjelduse ja/või näidispildi põhjal täiesti uus fondiperekond. Tagastab kohe lingi, mille olekut pärida — see on asünkroonne töö, mitte blokeeriv kutse.
| prompt | Stiilikirjeldus tavalises keeles. Valikuline, kui on antud reference_image_url. |
| reference_image_url | Otsene avalik pildilink — see peab olema kutse hetkel avalikult kättesaadav. |
| languages, weights, glyph_types, model_tier | Sama kuju ja vaikeväärtused nagu REST-lõpp-punktil — vaata API vahelehe jaotist Loo font. |
Päri fonditöö edenemist. Kui font on valmis, tagastab ttf/otf/woff/woff2 failide lingid. Pane tähele: need pole avalikult kättesaadavad (403) — baitide saamiseks kasuta tööriista download_font.
| linkkohustuslik | Fondi link, mille tagastas generate_font. |
Hangi fondifaili baidid otse MCP-ressursina, et agent saaks selle kohe sinu projekti kettale kirjutada. Ebatavaliselt suure faili puhul tagastab tavalise lingi.
| linkkohustuslik | Fondi link, mille tagastas generate_font. |
| format | ttf · otf · woff · woff2 — default ttf. |
Loetle kõik toetatud ISO-2 keelekoodid koos glüüfide arvu ja teksti suunaga — kasuta seda kehtiva languages-massiivi koostamiseks.
Loetle oma viimased 100 fonditööd — olek, mudel, allikas ja link iga fondi lehele.
MCP tööriistad on täpselt nii head kui kirjeldus nende taga. Need annavad järjekindlalt tugevaid tulemusi:
„Genereeri sõbralik ümarate vormidega sans-serif laste õpirakenduse jaoks, inglise ja hispaania keeles, normal- ja bold-paksuses — salvesta seejärel ttf-failid kausta ./public/fonts.“
Nimetab meeleolu, keeled, paksused ja tulemuse asukoha — agent saab kogu tsükli iseseisvalt läbida.
„Siin on ekraanipilt meie vanast logost: https://example.com/logo.png — genereeri selle stiiliga sobiv kuvafont, ultra-kvaliteet, ainult inglise keel.“
Näidispildid tabavad olemasolevat välimust paremini kui omadussõnad — model_tier: ultra tasub end pealkirja- ja kuvafontide puhul ära.
„Kontrolli fondi 8WeheWlTl olekut ja ütle, millal see valmis on, seejärel anna mulle woff2 link.“
Lihtne päri-ja-teata — hea viis vaadata, mis sai vestluse alguses käivitatud tööst.
„Milliseid kirillitsa ja kreeka keeli YoFont toetab? Mul on vaja fonti, mis katab vene, ukraina ja kreeka keele.“
Lase agendil kutsuda list_languages, selle asemel et ISO-koode mälu järgi oletada — nii väldid ebaõnnestunud generate_font kutset kirjavea tõttu.
„Genereeri sellest näidispildist geomeetriline kuvafont, oota valmimist, laadi siis ttf alla ja lisa see meie Tailwindi seadistusse kohandatud font-face'ina.“
Seob ühe korraldusega kokku kõik kolm tööriista — genereeri → päri → laadi alla — ja annab agendile konkreetse järgmise sammu.
„Näita mulle kõiki mu fonte ja ütle, millised on veel järjekorras või ebaõnnestunud.“
Hea kogu projekti oleku ülevaatamiseks ilma töölauda avamata.
Üksainus sinu päring võib käivitada kogu konveieri — agent hoolitseb pärimistsükli eest, sina näed lihtsalt tulemust.