Generuj czcionki, pobieraj glify i zarządzaj dostarczaniem programowo. Ten sam silnik co w aplikacji, o jeden token bearer od Ciebie.
Wszystkie zapytania używają tokenu bearer w nagłówku Authorization. Trzymaj go po stronie serwera.
Zaloguj się, żeby wygenerować działający klucz API — dostęp do API i MCP jest w planach Pro i Studio.
Zaloguj się, żeby odebrać kluczZapytania są limitowane dla każdego klucza API. Przekroczenie limitu zwraca 429 Too Many Requests z Retry-After. Limity rosną wraz z Twoim planem:
| Utwórz czcionkę · cała reszta | |
| Pro | 200 · 2 000 / min |
| Studio | 600 · 6 000 / min |
Potrzebujesz większej przepustowości? Podnieś swój plan.
Generuje kompletną rodzinę czcionek z opisu tekstowego i/albo obrazu referencyjnego. Zwraca zadanie, które odpytujesz aż do zakończenia.
| promptwymagane | Opis kroju pisma zwykłym językiem. Optional when reference_image_url is set. |
| reference_image_url | Obraz referencyjny stylu (PNG/JPG/WEBP) — bezpośredni publiczny adres URL. Nigdy go nie przechowujemy; przekazujemy link bez zmian do silnika renderującego, tak samo jak funkcja „zrzut ekranu na czcionkę” we wtyczkach do Figma i Chrome. |
| languages | Tablica kodów ISO — domyślnie ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | np. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Pobiera status czcionki i adresy do pobrania (TTF / WOFF2 / wersja zmienna).
Pobiera złożony plik czcionki w konkretnym formacie (ttf/otf/woff/woff2) — dokładnie ten sam plik, który daje przycisk pobierania w Studio.
Każdy obsługiwany dwuliterowy kod języka ISO-2 wraz z liczbą glifów na system pisma i kierunkiem pisma — użyj tego, żeby zbudować poprawną tablicę „languages”.
Twoje ostatnie 100 zadań czcionek — status, model, źródło i link do strony każdej czcionki.
Generowanie jest asynchroniczne. Po wysłaniu POST na generate odpytuj GET /api/public/status?link=… co kilka sekund, aż status będzie font_ready (albo failed).
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — ile atlasów glifów jest gotowych |
| fonts | adresy plików ttf/otf/woff/woff2, obecne gdy status = font_ready. Te adresy wymagają Twojego klucza API — pobranie ich bez nagłówka Authorization zwraca 403. Bajty pobierz przez GET /api/public/download?link=…&format=…. |
Odpytanie co 3–5 sekund w zupełności wystarczy — pełna rodzina zwykle kończy się w niecałe dwie minuty. Pliki pobieraj przez GET /api/public/download ze swoim kluczem API; adresy w polu „fonts” nie są publicznie dostępne.
Wszystkie błędy mają spójny kształt JSON: { "success": false, "error": "…" }.
| 400 | Błędne zapytanie — brakujące albo nieprawidłowe pola. Sprawdź error po szczegóły. |
| 401 | Brak autoryzacji — brakujący albo nieprawidłowy Authorization nagłówek. |
| 402 | Wymagana płatność — wyczerpany limit glifów. Doładuj na stronie Plany. |
| 403 | Brak dostępu — ten link należy do innego konta. |
| 404 | Nie znaleziono — takie ID czcionki nie istnieje albo należy do innego konta. |
| 429 | Zbyt wiele zapytań — przekroczony limit zapytań. Ponów po Retry-After. |
| 500 | Błąd wewnętrzny — coś poszło nie tak po naszej stronie. Ponowienie po kilku sekundach zwykle pomaga. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) pozwala agentom programistycznym AI — Claude Code, Cursor, Codex i innym — wywoływać YoFont bezpośrednio w trakcie pracy: wygenerować czcionkę w środku rozmowy, poczekać, aż się złoży, i wrzucić plik wprost do Twojego projektu. Bez kopiowania poleceń curl.
Każde wywołanie narzędzia MCP to cienka, przejrzysta nakładka na te same endpointy REST opisane w zakładce API — ta sama autoryzacja, te same limity, ta sama walidacja. Serwer MCP nie robi nic, czego nie ma w dokumentacji REST.
Skopiuj poniższe polecenie i wklej je do Claude Code, Cursora albo Codeksa. Twój agent sam zarejestruje serwer MCP YoFont i to zweryfikuje — żadnych plików konfiguracyjnych do ręcznej edycji.
Klucz odbierzesz w sekcji Uwierzytelnianie w zakładce API.
Skieruj swojego klienta MCP na https://yofont.com/api/public/mcp. Używa transportu Streamable HTTP (tryb odpowiedzi JSON) — jedno zapytanie JSON-RPC 2.0 na wywołanie, bez sesji ani gniazda do utrzymywania.
| Transport | Streamable HTTP (JSON-RPC 2.0 po POST). Metody: initialize, ping, tools/list, tools/call. |
| Autoryzacja | Ten sam klucz API co w REST API — wysyłaj go w nagłówku przy każdym zapytaniu: Authorization: Bearer yf_live_.... |
Pięć narzędzi, jeden do jednego z endpointami REST w zakładce API — w MCP nie ma nic, czego nie da się zrobić zwykłym RESTem.
Generuje zupełnie nową rodzinę czcionek z opisu i/albo obrazu referencyjnego. Zwraca od razu link do odpytywania — to zadanie asynchroniczne, nie wywołanie blokujące.
| prompt | Opis stylu zwykłym językiem. Opcjonalny, jeśli podasz reference_image_url. |
| reference_image_url | Bezpośredni publiczny adres obrazu — musi być po prostu publicznie dostępny w momencie wywołania. |
| languages, weights, glyph_types, model_tier | Ten sam kształt i te same wartości domyślne co w endpointcie REST — zobacz sekcję Utwórz czcionkę w zakładce API. |
Odpytuje postęp budowy zadania czcionki. Gdy jest gotowe, zwraca adresy plików ttf/otf/woff/woff2. Uwaga: nie są one publicznie dostępne (403) — po bajty użyj narzędzia download_font.
| linkwymagane | Link czcionki zwrócony przez generate_font. |
Pobiera bajty pliku czcionki jako zasób MCP, żeby Twój agent zapisał go od razu na dysku w projekcie. Przy nietypowo dużym pliku wraca do zwykłego adresu URL.
| linkwymagane | Link czcionki zwrócony przez generate_font. |
| format | ttf · otf · woff · woff2 — default ttf. |
Wypisuje każdy obsługiwany dwuliterowy kod języka ISO-2 wraz z liczbą glifów i kierunkiem pisma — użyj tego, żeby zbudować poprawną tablicę languages.
Wypisuje Twoje ostatnie 100 zadań czcionek — status, model, źródło i link do strony każdej czcionki.
Narzędzia MCP są tyle warte, ile polecenie, które za nimi stoi. Te dają konsekwentnie dobre efekty:
„Wygeneruj przyjazny, zaokrąglony krój bezszeryfowy do aplikacji edukacyjnej dla dzieci, po angielsku i hiszpańsku, grubość normalna i pogrubiona — a potem zapisz pliki ttf do ./public/fonts.”
Nazywa nastrój, języki, grubości i miejsce zapisu wyniku — agent przeprowadzi całą pętlę bez nadzoru.
„Oto zrzut naszego starego logo: https://example.com/logo.png — wygeneruj krój ozdobny pasujący do jego stylu, jakość ultra, tylko angielski.”
Obrazy referencyjne biją przymiotniki, gdy chodzi o dopasowanie do konkretnego istniejącego wyglądu — model_tier: ultra opłaca się przy krojach nagłówkowych i ozdobnych.
„Sprawdź status czcionki 8WeheWlTl i powiedz mi, kiedy będzie gotowa, a potem podaj adres woff2.”
Proste odpytanie i raport — dobre do sprawdzenia zadania uruchomionego wcześniej w rozmowie.
„Jakie języki cyrylickie i greckie obsługuje YoFont? Potrzebuję czcionki z rosyjskim, ukraińskim i greckim.”
Pozwól agentowi wywołać list_languages, zamiast zgadywać kody ISO z pamięci — unikniesz nieudanego generate_font przez literówkę w kodzie.
„Wygeneruj geometryczny krój ozdobny z tego obrazu referencyjnego, poczekaj, aż się skończy, potem pobierz ttf i dodaj go do naszej konfiguracji Tailwind jako własny font-face.”
Łączy wszystkie trzy narzędzia w jednym poleceniu — generowanie → odpytywanie → pobieranie — i daje agentowi konkretny następny krok.
„Pokaż mi wszystkie moje czcionki i powiedz, które wciąż czekają w kolejce albo się nie powiodły.”
Dobre do przeglądu statusów w całym projekcie bez otwierania panelu.
Jedno Twoje zapytanie może uruchomić cały przebieg — agent obsługuje pętlę odpytywania, a Ty widzisz tylko wynik.