साइन इन
साइन इन
Генеруйте шрифти, отримуйте гліфи та керуйте доставкою програмно. Той самий рушій, що й у застосунку, за один 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). |
Отримати статус шрифту та 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 | Прямі посилання 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) дозволяє ШІ-агентам для розробки — 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 — надсилайте його заголовком у кожному запиті: 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 працюють рівно настільки добре, наскільки добрий промпт за ними. Ці стабільно дають сильний результат:
«Згенеруй дружній заокруглений гротеск для дитячого освітнього застосунку, англійською та іспанською, начертання normal і bold — і збережи ttf-файли в ./public/fonts.»
Задає настрій, мови, начертання і куди покласти результат — агент може пройти весь цикл без вашої участі.
«Ось скриншот нашого старого лого: https://example.com/logo.png — згенеруй шрифт для заголовків у цьому ж стилі, якість ultra, лише англійська.»
Референс-зображення точніше за прикметники передає конкретний наявний стиль — model_tier: ultra виправданий для великих заголовкових начертань.
«Перевір статус шрифту 8WeheWlTl і повідом, коли буде готовий, потім дай посилання на woff2.»
Простий запит-і-звіт — зручно для перевірки завдання, запущеного раніше в цьому ж діалозі.
«Які кириличні та грецькі мови підтримує YoFont? Мені потрібен шрифт з російською, українською та грецькою.»
Нехай агент викличе list_languages замість вгадування ISO-кодів з пам'яті — це виключає невдалий виклик generate_font через помилку в коді.
«Згенеруй геометричний шрифт для заголовків за цим референс-зображенням, дочекайся готовності, потім завантаж ttf і додай як кастомний font-face в наш конфіг Tailwind.»
Пов'язує всі три інструменти в одній інструкції — генерація → опитування → завантаження — і дає агенту конкретний наступний крок.
«Покажи всі мої шрифти і скажи, які ще в черзі або впали з помилкою.»
Зручно для перевірки статусу по всьому проєкту, не відкриваючи дашборд.
Один ваш запит може запустити весь конвеєр цілком — цикл опитування статусу бере на себе агент, ви бачите лише результат.