Σύνδεση
Σύνδεση
Генерируйте шрифты, получайте глифы и управляйте доставкой прямо из кода. Движок тот же, что и в приложении, — нужен всего один 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) позволяет ИИ-агентам для разработки — 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.»
Связывает все три инструмента в одной инструкции — генерация → опрос → скачивание — и даёт агенту конкретный следующий шаг.
«Покажи все мои шрифты и скажи, какие ещё в очереди или упали с ошибкой.»
Удобно для проверки статуса по всему проекту, не открывая дашборд.
Один ваш запрос может запустить весь конвейер целиком — цикл опроса статуса берёт на себя агент, вы видите только результат.