Ариптерди жасаңыз, белгилерди алыңыз жана жеткирүүнү программа аркылуу башкарыңыз. Колдонмодогу ошол эле кыймылдаткыч, бир 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 катары кош.»
Бир нускамада үч куралды тең тизмектейт — жасоо → текшерүү → жүктөө — жана агентке конкреттүү кийинки кадамды берет.
«Бардык ариптеримди көрсөт да, кайсынысы дагы эле кезекте же ишке ашпай калганын айт.»
Панелди ачпай туруп, бүт долбоор боюнча абалды бир карап чыгууга ыңгайлуу.
Сиздин бир сурамыңыз бүт тизмекти жүргүзө алат — агентиңиз текшерүү айлампасын өзү тейлейт, сиз жыйынтыкты гана көрөсүз.