Увійти
Увійти
Генерирайте шрифтове, дърпайте глифове и управлявайте доставката им — програмно. Същият двигател като в приложението, само на един 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) — директен публичен адрес. Никога не го съхраняваме; препращаме връзката както е към машината за рендиране, също както плъгините за 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) — същият файл, който получавате и с бутона за изтегляне в 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 | Директни ttf/otf/woff/woff2 адреси, налични щом status = font_ready. |
Проверка на всеки 3–5 секунди е напълно достатъчна — цялото семейство обикновено завършва за по-малко от няколко минути. Адресите на файловете на шрифта са статични и не изискват удостоверяване, щом бъдат върнати.
Всички грешки връщат един и същ 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 | Директен публичен адрес на изображение — просто трябва да е публично достъпен в момента на извикването. |
| languages, weights, glyph_types, model_tier | Същата структура и стойности по подразбиране като при REST ендпойнта — вижте раздел „Създай шрифт“ в таба API. |
Проверява напредъка на изграждане на задача за шрифт. Щом е готова, връща директни ttf/otf/woff/woff2 адреси — изтегляте ги директно, без нужда от удостоверяване.
| linkзадължително | Връзката към шрифта, върната от generate_font. |
Взема байтовете на файла на шрифта направо като MCP ресурс, за да може агентът ви да го запише директно на диска в проекта ви. При необичайно голям файл връща обикновен адрес вместо това.
| linkзадължително | Връзката към шрифта, върната от generate_font. |
| format | ttf · otf · woff · woff2 — default ttf. |
Изброява всички поддържани ISO-2 кодове на езици с брой глифове и посока на текста — използвайте го, за да съставите валиден масив languages.
Изброява последните ви 100 задачи за шрифтове — статус, модел, източник и връзка към страницата на всеки шрифт.
Инструментите на MCP са толкова добри, колкото е промптът зад тях. Тези дават стабилно силни резултати:
„Генерирай приятелски, заоблен sans-serif шрифт за детско образователно приложение, на английски и испански, с нормално и получер начертание — след това запази ttf файловете в ./public/fonts.“
Задава настроението, езиците, начертанията и къде да се запази резултатът — агентът може да мине целия цикъл без намеса.
„Ето скрийншот на старото ни лого: https://example.com/logo.png — генерирай дисплей шрифт в същия стил, качество ultra, само на английски.“
Референтните изображения предават конкретен съществуващ стил по-точно от прилагателните — model_tier: ultra си заслужава за големи заглавни (hero/дисплей) шрифтове.
„Провери статуса на шрифт 8WeheWlTl и ми кажи, когато е готов, после ми дай woff2 адреса.“
Прост цикъл на проверка и отчет — удобно за проследяване на задача, стартирана по-рано в разговора.
„Кои кирилски и гръцки езици поддържа YoFont? Трябва ми шрифт, покриващ руски, украински и гръцки.“
Оставете агента да извика list_languages, вместо да гадае ISO кодове по памет — така се избягва неуспешно извикване на generate_font заради сгрешен код.
„Генерирай геометричен дисплей шрифт по това референтно изображение, изчакай да завърши, после изтегли ttf файла и го добави в конфигурацията ни на Tailwind като персонализиран font-face.“
Свързва и трите инструмента в една инструкция — генериране → проверка на статус → изтегляне — и дава на агента конкретна следваща стъпка.
„Покажи ми всичките ми шрифтове и кажи кои са още в опашката или са се провалили.“
Удобно за бърза проверка на статуса в целия проект, без да отваряте таблото за управление.
Една ваша заявка може да задейства целия процес — агентът поема цикъла на проверка на статуса, а вие виждате само резултата.