YoFont — AI font generator
Forbróirí · REST v1

YoFont API/MCP

Gin clónna, faigh glifeanna agus bainistigh an seachadadh go cláraitheach. An t-inneall céanna leis an aip, comhartha iompróra amháin uait.

// Fíordheimhniú

Úsáideann gach iarratas comhartha iompróra sa cheanntásc Authorization. Coinnigh ar thaobh an fhreastalaí é.

Sínigh isteach chun eochair API bheo a ghiniúint — tá rochtain API agus MCP san áireamh leis na pleananna Pro agus Studio.

// Teorainneacha ráta

Tá teorainn le hiarratais in aghaidh na heochrach API. Seolann dul thar an teorainn 429 Too Many Requests le Retry-After. Scálaíonn na teorainneacha le do phlean:

Cruthaigh cló · gach rud eile
Pro200 · 2 000 / nóim
Studio600 · 6 000 / nóim

Tuilleadh tréchuir uait? Uasghrádaigh do phlean.

POST/api/public/generate

Gin teaghlach cló iomlán ó leid théacs agus/nó ó íomhá thagartha. Seolann sé tasc ar ais a dhéanann tú a vótáil go dtí go gcríochnaíonn sé.

promptriachtanachCur síos i ngnáthchaint ar an gclófhoireann. Optional when reference_image_url is set.
reference_image_urlÍomhá thagartha stíle (PNG/JPG/WEBP) — URL poiblí díreach. Ní stórálaimid riamh í; seolaimid an nasc ar aghaidh mar atá chuig an inneall rindreála, díreach mar a dhéanann gabháil-scáileáin-go-cló na mbreiseán Figma/Chrome.
languagesEagar de chóid ISO — is é an réamhshocrú ["en"]. Two-letter ISO codes, full list: GET /api/public/languages.
weightsm.sh. ["normal","bold","thin"].
glyph_typesletters · digits · punct · special (default all).
model_tierstandard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5).

                
200Glactha — seolann sé ar ais { success, link, task_id, glyphs_charged, status_url }
// Response JSON

                
402Glifeanna ídithe — breisigh ar leathanach na bPleananna
GET/api/public/status?link=…

Faigh stádas cló agus na URLanna íoslódála (TTF / WOFF2 / athróg).

// Request

                
// Response JSON

                
GET/api/public/download?link=…

Íoslódáil an comhad cló tógtha i bhformáid ar leith (ttf/otf/woff/woff2) — an comhad céanna a chruthaíonn cnaipe íoslódála an Stiúideo.

// Request

                
// Response

                
GET/api/public/languages

Gach cód teanga ISO-2 a dtacaítear leis, le líon na nglifeanna in aghaidh na scripte agus treo an téacs — úsáid é chun eagar "languages" bailí a thógáil.

// Request

                
// Response JSON

                
GET/api/public/fonts

Do 100 tasc cló is déanaí — stádas, samhail, foinse agus nasc chuig leathanach gach cló.

// Request

                
// Response JSON

                
// Vótáil

Tá an ghiniúint asionchronach. Tar éis POST chuig generate, vótáil GET /api/public/status?link=… gach cúpla soicind go dtí go mbeidh an stádas font_ready (nó failed).

statusqueued · processing · atlas_ready · font_ready · failed
progress{ total, completed, failed } — cé mhéad atlas glifeanna atá déanta
fontsURLanna comhad ttf/otf/woff/woff2, i láthair a luaithe a bhíonn status = font_ready. Teastaíonn d'eochair API ó na URLanna seo — seolann iad a aimsiú gan an ceanntásc Authorization 403 ar ais. Íoslódáil na bearta trí GET /api/public/download?link=…&format=….

Is leor vóta gach 3–5 soicind — is gnách go gcríochnaíonn teaghlach iomlán faoi bhun cúpla nóiméad. Faigh na comhaid trí GET /api/public/download le d'eochair API; níl na URLanna in "fonts" inrochtana go poiblí.

// Earráidí

Leanann gach earráid an cruth comhsheasmhach JSON céanna: { "success": false, "error": "…" }.

400Drochiarratas — réimsí in easnamh nó neamhbhailí. Seiceáil an error le haghaidh sonraí.
401Neamhúdaraithe — in easnamh nó neamhbhailí Authorization ceanntásc.
402Teastaíonn íocaíocht — cuóta glifeanna ídithe. Breisigh ar leathanach na bPleananna.
403Toirmiscthe — baineann an nasc le cuntas eile.
404Gan aimsiú — níl aitheantas an chló ann nó baineann sé le cuntas eile.
429An iomarca iarratas — teorainn ráta sroichte. Bain triail eile as tar éis Retry-After.
500Earráid inmheánach — chuaigh rud éigin amú ar ár dtaobh. Is gnách go n-oibríonn athiarracht tar éis cúpla soicind.
{
  "success": false,
  "error": "Not enough glyphs. Top up: https://yofont.com/plans"
}