Ҳуруф созед, глифҳо гиред ва расониданро ба таври барномавӣ идора кунед. Ҳамон муҳаррики барнома, танҳо як токени 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 кори охирини ҳуруфи шумо — ҳолат, модел, манбаъ ва пайванд ба саҳифаи ҳар ҳуруф.
Сохтан ғайрихамзамон аст. Пас аз POST ба generate, бипурсед 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 сония кофист — оилаи пурра одатан дар камтар аз ду дақиқа тайёр мешавад. Файлҳоро тавассути GET /api/public/download бо калиди API-и худ гиред; нишониҳои дохили "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 пӯшиши тунуку шаффофи ҳамон нуқтаҳои 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-ро бармегардонад. Диққат: онҳо ошкоро дастрас нестанд (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 кадом забонҳои кириллӣ ва юнониро дастгирӣ мекунад? Ба ман ҳуруфе лозим аст, ки русӣ, украинӣ ва юнониро фаро гирад.»
Бигзор агент list_languages-ро даъват кунад, на ин ки рамзҳои ISO-ро аз ёд тахмин занад — ин даъвати нашудаи generate_font-ро аз хатои рамз пешгирӣ мекунад.
«Аз ин тасвири намунавӣ ҳуруфи намоишии геометрӣ соз, интизори анҷомаш шав, баъд ttf-ро зеркашӣ кун ва онро ба танзимоти Tailwind-и мо ҳамчун font-face-и фармоишӣ илова намо.»
Ҳар се абзорро дар як дастур ба ҳам мепайвандад — сохтан → пурсиш → зеркашӣ — ва ба агент қадами мушаххаси навбатиро медиҳад.
«Ҳамаи ҳуруфи маро нишон деҳ ва бигӯ, кадомашон ҳанӯз дар навбатанд ё нашуданд.»
Барои назари умумӣ ба ҳолати тамоми лоиҳа бидуни кушодани панели идора хуб аст.
Як дархости шумо метавонад тамоми занҷирро ба кор андозад — агент давраи пурсишро худаш мебарад, шумо танҳо натиҷаро мебинед.