Шрифтларны программа юлы белән ясагыз, билгеләрне алыгыз һәм тапшыруны көйләгез. Кушымтадагы шул ук механизм, бер bearer токены ераклыкта.
Барлык сораулар да bearer токенын куллана, ул шушы башлыкта: Authorization. Аны сервер ягында саклагыз.
Эшли торган API ачкычы ясар өчен керегез — API һәм MCP рөхсәте Pro һәм Studio тарифларына керә.
Ачкычыгызны алыр өчен керегезСораулар һәр API ачкычы буенча чикләнә. Чиктән узсагыз, бу кайтарыла: 429 Too Many Requests шушының белән: Retry-After. Чикләр тарифыгыз белән бергә үсә:
| Шрифт ясау · калганнары | |
| Pro | 200 · 2 000 / мин |
| Studio | 600 · 6 000 / мин |
Күбрәк үткәрү сәләте кирәкме? Тарифыгызны күтәрегез.
Текст сораудан һәм/яисә үрнәк рәсемнән тулы шрифт гаиләсе ясый. Тәмамлануын тикшереп тора торган эш кайтара.
| 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) — Студиядәге йөкләү төймәсе биргән шул ук файл.
Ярдәм ителә торган барлык ISO-2 тел кодлары, язу буенча билге саннары һәм текст юнәлеше белән — дөрес "languages" исемлеген төзер өчен кулланыгыз.
Соңгы 100 шрифт эшегез — хәле, моделе, чыганагы һәм һәр шрифтның битенә сылтама.
Ясау асинхрон бара. generate га POST җибәргәч, шуны тикшерегез: GET /api/public/status?link=… хәл font_ready (яки failed) булганчы, берничә секунд саен.
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — ничә билге атласы әзер |
| fonts | ttf/otf/woff/woff2 файл сылтамалары, шул чакта була: status = font_ready. Бу сылтамалар өчен API ачкычыгыз кирәк — Authorization башлыгыннан башка сорасаң, 403 кайта. Эчтәлекне шушы аша йөкләгез: GET /api/public/download?link=…&format=…. |
3–5 секунд саен бер тикшерү җитә — тулы гаилә гадәттә берничә минуттан да азрак вакытта бетә. Файлларны API ачкычыгыз белән GET /api/public/download аша алыгыз; "fonts" тагы сылтамалар ачыктан ачылмый.
Барлык хаталар да бердәм 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 корал чакыруы — API кыстырмасында тасвирланган шул ук REST очлары өстендәге нечкә, ачык катлам: шул ук авторизация, шул ук чикләр, шул ук тикшерү. MCP сервере эшләгән бернәрсә дә REST документларыннан яшерелми.
Түбәндәге сорауны күчереп алыгыз да Claude Code, Cursor яки Codex ка куегыз. Агентыгыз YoFont MCP серверын үзе теркәячәк һәм тикшерәчәк — кулдан төзәтәсе көйләү файллары юк.
Ачкычыгызны API кыстырмасындагы Авторизация бүлегеннән алыгыз.
MCP клиентыгызны монда юнәлтегез: https://yofont.com/api/public/mcp. Ул Streamable HTTP транспортында сөйләшә (JSON җавап режимы) — һәр мөрәҗәгатькә бер JSON-RPC 2.0 соравы, ачык тотасы сеанс яки сокет юк.
| Транспорт | Streamable HTTP (POST аша JSON-RPC 2.0). Методлар: initialize, ping, tools/list, tools/call. |
| Авторизация | REST API дагы шул ук API ачкычы — аны һәр сорауда башлык итеп җибәрегез: Authorization: Bearer yf_live_.... |
Биш корал, API кыстырмасындагы REST очлары белән берәмтеккә-берәм — MCP та гади REST та булмаган бернәрсә дә юк.
Сораудан һәм/яисә үрнәк рәсемнән бөтенләй яңа шрифт гаиләсе ясый. Шунда ук тикшереп торыр өчен сылтама кайтара — бу асинхрон эш, тоткарлаучы чакыру түгел.
| prompt | Гади сүзләр белән стиль тасвирламасы. reference_image_url бирелсә, мәҗбүри түгел. |
| reference_image_url | Турыдан-туры ачык рәсем сылтамасы — чакыру вакытында ачыктан ала алырлык булуы гына кирәк. |
| languages, weights, glyph_types, model_tier | REST очындагы кебек үк форма һәм гадәти кыйммәтләр — API кыстырмасының «Шрифт ясау» бүлеген карагыз. |
Шрифт эшенең җыелу барышын тикшерә. Әзер булгач, ttf/otf/woff/woff2 файл сылтамаларын кайтара. Искәрмә: аларны ачыктан алып булмый (403) — эчтәлеген алыр өчен download_font коралын кулланыгыз.
| 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 кайсы кирилл һәм грек телләренә ярдәм итә? Миңа рус, украин һәм грек телләрен каплаган шрифт кирәк.»
ISO кодларын хәтердән фаразлау урынына агент list_languages ны чакырсын — код хатасы аркасында generate_font ның уңышсыз чакырылуын булдырмый.
«Бу үрнәк рәсемнән геометрик башлык шрифты ясагыз, ул бетүен көт, аннары ttf ны йөклә һәм аны Tailwind көйләвебезгә үзебезнең font-face итеп өстә.»
Өч коралны да бер күрсәтмәдә чылбырга бәйли — ясау → тикшерү → йөкләү — һәм агентка конкрет киләсе адымны бирә.
«Барлык шрифтларымны күрсәт һәм кайсылары әле чиратта яки уңышсыз булуын әйт.»
Панельне ачмыйча гына бөтен проект буенча хәлне карап чыгу өчен уңайлы.
Сезнең бер соравыгыз бөтен конвейерны җибәрә ала — тикшереп тору циклын агент үзе алып бара, сез нәтиҗәне генә күрәсез.