Қаріп жасаңыз, таңбаларды алыңыз және жеткізуді бағдарламалық түрде басқарыңыз. Қозғалтқыш қосымшадағымен бірдей, бір 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 / variable).
Жиналған қаріп файлын нақты пішімде жүктеу (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 ретінде қос.»
Бір нұсқауда үш құралды тізбектейді — жасау → тексеру → жүктеу — және агентке нақты келесі қадам береді.
«Барлық қаріптерімді көрсетші де, қайсысы әлі кезекте тұрғанын немесе сәтсіз аяқталғанын айт.»
Басқару тақтасын ашпай, бүкіл жоба бойынша күйді шолып шығуға ыңғайлы.
Сіздің бір сұранысыңыз бүкіл тізбекті іске қоса алады — тексеру циклын агент өзі жүргізеді, сіз тек нәтижені көресіз.