Sign In
Sign In
Генерирајте фонтови, преземајте глифови и управувајте со испораката програмски. Истиот мотор како во апликацијата — достапен со само еден bearer токен.
Сите барања користат bearer токен во Authorization заглавието. Чувајте го на серверот.
Најавете се за да генерирате активен API клуч — бесплатно е, секој план вклучува пристап до API-то.
Најавете се за да го добиете вашиот клучБарањата се ограничени по API клуч. Надминувањето на лимитот враќа 429 Too Many Requests со Retry-After. Лимитите растат со вашиот план:
| Создај фонт · сè друго | |
| Starter | 60 · 600 / мин |
| Pro | 200 · 2 000 / мин |
| Agency | 600 · 6 000 / мин |
Ви треба поголем капацитет? Надградете го вашиот план.
Генерирајте цело семејство фонтови од текстуален опис и/или референтна слика. Ви враќа задача чиј статус го проверувате додека не заврши.
| promptзадолжително | Опис на фонтот со обичен јазик. Optional when reference_image_url is set. |
| reference_image_url | Референтна слика за стил (PNG/JPG/WEBP) — директен јавен URL. Никогаш не ја чуваме; линкот го препраќаме непроменет до моторот за рендерирање, исто како при генерирање од скриншот кај приклучоците за 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). |
Земете го статусот на фонтот и URL-адресите за преземање (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 | Директни URL-адреси за ttf/otf/woff/woff2, присутни штом status = font_ready. |
Проверка на секои 3–5 секунди е доволна — целото семејство обично завршува за помалку од неколку минути. URL-адресите на датотеките на фонтот се статични и не бараат автентикација откако ќе бидат вратени.
Сите грешки следат конзистентен 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) им овозможува на AI агентите за пишување код — 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 | Директен јавен URL на слика — потребно е само да биде јавно достапна во моментот на повикот. |
| languages, weights, glyph_types, model_tier | Иста структура и стандардни вредности како REST крајната точка — видете го делот Создај фонт во табот API. |
Проверувајте го напредокот на градење на задачата за фонт. Штом ќе биде готова, враќа директни URL-адреси за ttf/otf/woff/woff2 — преземете ги директно, без потребна автентикација.
| linkзадолжително | Линкот на фонтот вратен од generate_font. |
Земете ги бајтовите на датотеката на фонтот директно како MCP ресурс, за вашиот агент веднаш да ја запише на диск во вашиот проект. Ако датотеката е невообичаено голема, наместо тоа враќа обичен URL.
| linkзадолжително | Линкот на фонтот вратен од generate_font. |
| format | ttf · otf · woff · woff2 — default ttf. |
Прикажете ги сите поддржани ISO-2 кодови на јазици со број на глифови и насока на текстот — искористете ги за да составите валидна низа languages.
Прикажете ги вашите последни 100 задачи за фонтови — статус, модел, извор и линк до страницата на секој фонт.
Алатките на MCP се толку добри колку што е добар промптот зад нив. Овие постојано даваат силни резултати:
„Генерирај пријателски, заоблен безсерифен фонт за детска образовна апликација, на англиски и шпански, обично и задебелено — и зачувај ги ttf датотеките во ./public/fonts.“
Ги наведува расположението, јазиците, дебелините и каде да се стави резултатот — агентот може сам да го изврши целиот процес.
„Еве скриншот од нашето старо лого: https://example.com/logo.png — генерирај насловен фонт што го одразува неговиот стил, квалитет ultra, само англиски.“
Референтните слики поточно го пренесуваат конкретен постоечки изглед отколку описни зборови — model_tier: ultra си вреди за насловни/hero фонтови.
„Провери го статусот на фонтот 8WeheWlTl и кажи ми кога ќе биде готов, потоа дај ми го woff2 URL-то.“
Едноставна проверка и известување — корисно за следење задача започната порано во разговорот.
„Кои кирилски и грчки јазици ги поддржува YoFont? Ми треба фонт што опфаќа руски, украински и грчки.“
Оставете го агентот да повика list_languages наместо да ги погодува ISO кодовите од памет — така се избегнува неуспешен повик на generate_font поради погрешно внесен код.
„Генерирај геометриски насловен фонт од оваа референтна слика, почекај да заврши, потоа преземи го ttf-то и додај го во нашата Tailwind конфигурација како прилагоден font-face.“
Ги поврзува сите три алатки во една инструкција — генерирање → проверка → преземање — и му дава на агентот конкретен следен чекор.
„Покажи ми ги сите мои фонтови и кажи ми кои сè уште чекаат во редот или не успеале.“
Корисно за брз преглед на статусот на целиот проект без отворање на контролната табла.
Едно ваше барање може да го поттикне целиот процес — вашиот агент се грижи за циклусот на проверка, а вие само го гледате резултатот.