Anmelden
Anmelden
Генеруйце шрыфты, забірайце гліфы і кіруйце дастаўкай праграмна. Той самы рухавік, што і ў дадатку, — усё, што трэба, гэта адзін bearer-токен.
Ва ўсіх запытах перадаецца bearer-токен у загалоўку Authorization. Захоўвайце яго толькі на серверы.
Увайдзіце, каб стварыць працоўны API-ключ — гэта бясплатна, доступ да API ёсць у кожным плане.
Увайдзіце, каб атрымаць свой ключЗапыты абмежаваны для кожнага API-ключа асобна. Перавышэнне ліміту вяртае 429 Too Many Requests з загалоўкам Retry-After. Ліміты растуць разам з планам:
| Стварыць шрыфт · усё астатняе | |
| Starter | 60 · 600 / хв |
| Pro | 200 · 2 000 / хв |
| Agency | 600 · 6 000 / хв |
Патрэбна больш? Перайсці на вышэйшы план.
Згенеруйце цэлы шрыфт з тэкставага запыту і/або відарыса-рэферэнсу. Вяртае задачу, якую можна апытваць або адсочваць праз webhook.
| promptабавязкова | Апісанне шрыфта простай мовай. Optional when reference_image_url is set. |
| reference_image_url | Відарыс-рэферэнс стылю (PNG/JPG/WEBP) — прамая публічная спасылка. Мы яго не захоўваем: перадаём спасылку як ёсць у рухавік рэндэру, гэтак жа, як плагіны Figma/Chrome пры генерацыі па скрыншоце. |
| languages | Масіў ISO-кодаў — стандартна ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | напр. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Атрымайце статус шрыфта і спасылкі на спампоўку (TTF / WOFF2 / зменны).
Спампуйце гатовы файл шрыфта ў патрэбным фармаце (ttf/otf/woff/woff2) — той самы файл, які дае кнопка спампоўкі ў Studio.
Усе падтрыманыя ISO-2 коды моў з колькасцю гліфаў для кожнай пісьменнасці і напрамкам тэксту — зручна для стварэння карэктнага масіва "languages".
Апошнія 100 вашых задач на шрыфты — статус, мадэль, крыніца і спасылка на старонку кожнага шрыфта.
Генерацыя асінхронная. Пасля POST на generate апытвайце GET /api/public/status?link=… кожныя некалькі секунд, пакуль статус не стане font_ready (або failed).
| status | queued · processing · font_ready · failed |
| progress | { total, completed, failed } — колькі атласаў гліфаў гатова |
| fonts | Прамыя спасылкі ttf/otf/woff/woff2, з'яўляюцца, калі status = font_ready. |
Апытання раз у 3–5 секунд дастаткова — поўны шрыфт звычайна збіраецца менш чым за пару хвілін. Спасылкі на файлы шрыфта статычныя і не патрабуюць аўтэнтыфікацыі пасля таго, як яны вернуты.
Усе памылкі маюць аднолькавы фармат JSON: { "success": false, "error": "…" }.
| 400 | Няправільны запыт — адсутнічаюць або некарэктныя палі. Праверце error для падрабязнасцей. |
| 401 | Не аўтарызавана — адсутнічае або некарэктны Authorization загаловак. |
| 402 | Патрабуецца аплата — квота гліфаў вычарпана. Папоўніце на старонцы Планы. |
| 403 | Забаронена — спасылка належыць іншаму акаўнту. |
| 404 | Не знойдзена — ID шрыфта не існуе або належыць іншаму акаўнту. |
| 429 | Занадта шмат запытаў — дасягнуты ліміт запытаў. Паўтарыце праз Retry-After. |
| 500 | Унутраная памылка — нешта пайшло не так з нашага боку. Паўтор праз некалькі секунд звычайна дапамагае. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) дазваляе ШІ-агентам для распрацоўкі — Claude Code, Cursor, Codex і іншым — звяртацца да YoFont проста падчас працы: згенераваць шрыфт пасярод дыялогу, дачакацца зборкі і адразу пакласці файл у ваш праект. Ніякіх curl-каманд уручную.
Кожны выклік інструмента MCP — тонкая, празрыстая абгортка над тымі ж REST-эндпоінтамі, што апісаныя ва ўкладцы API: тая ж аўтэнтыфікацыя, тыя ж ліміты запытаў, тая ж валідацыя. У MCP-серверы няма нічога, што не задакументавана ў REST.
Скапіюйце запыт ніжэй і ўстаўце яго ў Claude Code, Cursor або Codex. Ваш агент сам зарэгіструе MCP-сервер YoFont і праверыць яго — ніякіх канфігаў уручную рэдагаваць не трэба.
Атрымайце ключ у раздзеле «Аўтэнтыфікацыя» ва ўкладцы API.
Пакажыце вашаму MCP-кліенту адрас https://yofont.com/api/public/mcp. Выкарыстоўваецца транспарт Streamable HTTP (рэжым адказу JSON) — адзін запыт JSON-RPC 2.0 на выклік, без пастаяннага сокета ці сесіі.
| Транспарт | Streamable HTTP (JSON-RPC 2.0 па-над POST). Метады: initialize, ping, tools/list, tools/call. |
| Аўтарызацыя | Той жа API-ключ, што і ў REST API, — дасылайце яго загалоўкам у кожным запыце: Authorization: Bearer yf_live_.... |
Пяць інструментаў, якія адзін да аднаго адпавядаюць REST-эндпоінтам ва ўкладцы API, — у MCP няма нічога, чаго няма ў звычайным REST.
Згенеруйце новы шрыфт з нуля па запыце і/або відарысе-рэферэнсе. Адказ прыходзіць адразу са спасылкай для апытвання — гэта асінхронная задача, а не блакавальны выклік.
| prompt | Апісанне стылю простай мовай. Неабавязкова, калі пададзены reference_image_url. |
| reference_image_url | Прамая публічная спасылка на відарыс — дастаткова, каб яна была даступная публічна ў момант выкліку. |
| languages, weights, glyph_types, model_tier | Той жа фармат і стандартныя значэнні, што і ў REST-эндпоінце, — гл. раздзел «Стварыць шрыфт» ва ўкладцы API. |
Апытвайце прагрэс зборкі шрыфта. Калі ён гатовы, вяртаюцца прамыя спасылкі ttf/otf/woff/woff2 — іх можна спампоўваць без аўтэнтыфікацыі.
| linkабавязкова | Спасылка на шрыфт, якую вярнуў generate_font. |
Атрымайце байты файла шрыфта проста ў адказе як MCP-рэсурс, каб ваш агент мог адразу запісаць яго на дыск у вашым праекце. Пры незвычайна вялікім файле вяртаецца звычайная спасылка.
| linkабавязкова | Спасылка на шрыфт, якую вярнуў generate_font. |
| format | ttf · otf · woff · woff2 — default ttf. |
Спіс усіх падтрыманых ISO-2 кодаў моў з колькасцю гліфаў і напрамкам тэксту — зручна для стварэння карэктнага масіва languages.
Апошнія 100 вашых задач на шрыфты — статус, мадэль, крыніца і спасылка на старонку кожнага шрыфта.
Інструменты MCP настолькі добрыя, наколькі добры запыт за імі. Гэтыя стабільна даюць моцны вынік:
«Згенеруй дружалюбны скруглены гротэск для дзіцячага адукацыйнага дадатку, на англійскай і іспанскай, таўшчыні normal і bold — а потым захавай ttf-файлы ў ./public/fonts.»
Задае настрой, мовы, таўшчыні і месца для выніку — агент можа прайсці ўвесь цыкл без вашага ўдзелу.
«Вось скрыншот нашага старога лагатыпа: https://example.com/logo.png — згенеруй дысплейны шрыфт у гэтым жа стылі, якасць ultra, толькі англійская.»
Відарыс-рэферэнс дакладней за прыметнікі перадае канкрэтны існуючы стыль — model_tier: ultra апраўдана для буйных загалоўкавых шрыфтоў.
«Правер статус шрыфта 8WeheWlTl і скажы, калі ён будзе гатовы, потым дай спасылку на woff2.»
Просты апыт-і-справаздача — зручна для праверкі задачы, запушчанай раней у гэтым жа дыялогу.
«Якія кірылічныя і грэчаскія мовы падтрымлівае YoFont? Мне патрэбны шрыфт з рускай, украінскай і грэчаскай.»
Няхай агент выкліча list_languages замест таго, каб угадваць ISO-коды па памяці, — гэта пазбягае няўдалага выкліку generate_font з-за апіскі ў кодзе.
«Згенеруй геаметрычны дысплейны шрыфт па гэтым відарысе-рэферэнсе, дачакайся завяршэння, потым спампуй ttf і дадай яго ў наш канфіг Tailwind як уласны font-face.»
Звязвае ўсе тры інструменты ў адной інструкцыі — генерацыя → апытванне → спампоўка — і дае агенту канкрэтны наступны крок.
«Пакажы ўсе мае шрыфты і скажы, якія яшчэ ў чарзе або са збоем.»
Добра падыходзіць для хуткай праверкі статусу па ўсім праекце без адкрыцця панэлі кіравання.
Адзін ваш запыт можа запусціць увесь канвеер цалкам — цыкл апытвання бярэ на сябе ваш агент, вы бачыце толькі вынік.