Fontları program aracılığıyla üretin, glifleri getirin ve dağıtımı yönetin. Uygulamayla aynı motor, tek bir bearer belirteci uzağınızda.
Tüm istekler şu başlıkta bir bearer belirteci kullanır: Authorization. Belirteci sunucu tarafında tutun.
Canlı bir API anahtarı üretmek için giriş yapın — API ve MCP erişimi Pro ve Studio planlarına dâhildir.
Anahtarınızı almak için giriş yapınİstekler API anahtarı başına sınırlanır. Sınırı aşmak şunu döndürür: 429 Too Many Requests şununla: Retry-After. Sınırlar planınızla birlikte artar:
| Font oluştur · geri kalan her şey | |
| Pro | 200 · 2 000 / dk |
| Studio | 600 · 6 000 / dk |
Daha fazla kapasite mi lazım? Planınızı yükseltin.
Bir metin açıklamasından ve/veya referans görselden eksiksiz bir yazı ailesi üretir. Tamamlanması için izleyeceğiniz bir iş döndürür.
| promptzorunlu | Yazı ailesinin sade dille açıklaması. Optional when reference_image_url is set. |
| reference_image_url | Üslup referansı görseli (PNG/JPG/WEBP) — doğrudan, herkese açık bir adres. Onu asla saklamayız; bağlantıyı olduğu gibi işleme motoruna iletiriz, tıpkı Figma/Chrome eklentilerinin ekran görüntüsünden fonta özelliği gibi. |
| languages | ISO kodları dizisi — varsayılan: ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | örn. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Bir fontun durumunu ve indirme adreslerini getirir (TTF / WOFF2 / değişken).
Kurulan font dosyasını belirli bir formatta indirir (ttf/otf/woff/woff2) — Stüdyo'nun indirme düğmesinin ürettiği dosyanın aynısı.
Desteklenen tüm ISO-2 dil kodları, yazı sistemi başına glif sayıları ve metin yönüyle — geçerli bir "languages" dizisi kurmak için kullanın.
Son 100 font işiniz — durum, model, kaynak ve her fontun sayfasına bir bağlantı.
Üretim eşzamansızdır. generate'e POST ettikten sonra şunu izleyin: GET /api/public/status?link=… durum font_ready (ya da failed) olana dek birkaç saniyede bir.
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — kaç glif atlası bitti |
| fonts | ttf/otf/woff/woff2 dosya adresleri; şu andan itibaren bulunur: status = font_ready. Bu adresler API anahtarınızı gerektirir — Authorization başlığı olmadan çekmek 403 döndürür. Baytları şunun üzerinden indirin: GET /api/public/download?link=…&format=…. |
3–5 saniyede bir izlemek fazlasıyla yeterlidir — eksiksiz bir aile genellikle birkaç dakikadan kısa sürede biter. Dosyaları API anahtarınızla GET /api/public/download üzerinden çekin; "fonts" içindeki adresler herkese açık değildir.
Tüm hatalar tutarlı bir JSON biçimini izler: { "success": false, "error": "…" }.
| 400 | Hatalı istek — eksik ya da geçersiz alanlar. Şuna bakın: error ayrıntılar için. |
| 401 | Yetkisiz — eksik ya da geçersiz Authorization başlığı. |
| 402 | Ödeme gerekiyor — glif kotası tükendi. Planlar sayfasından yükleyin. |
| 403 | Yasak — bağlantı başka bir hesaba ait. |
| 404 | Bulunamadı — font kimliği yok ya da başka bir hesaba ait. |
| 429 | Çok fazla istek — hız sınırına takıldınız. Şundan sonra yeniden deneyin: Retry-After. |
| 500 | Dâhilî hata — bizim tarafımızda bir şeyler ters gitti. Birkaç saniye sonra yeniden denemek genellikle işe yarar. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol), yapay zekâ kodlama ajanlarının — Claude Code, Cursor, Codex ve diğerleri — çalışırken YoFont'u doğrudan çağırmasını sağlar: konuşmanın ortasında bir font üretir, kurulmasını bekler ve dosyayı doğrudan projenize bırakır. Kopyala-yapıştır curl komutlarına gerek yok.
Her MCP araç çağrısı, API sekmesinde belgelenen aynı REST uç noktalarının ince ve şeffaf bir sarmalayıcısıdır — aynı kimlik doğrulama, aynı hız sınırları, aynı doğrulama. MCP sunucusunun yaptığı hiçbir şey REST belgelerinden gizli değildir.
Aşağıdaki isteği kopyalayıp Claude Code, Cursor ya da Codex'e yapıştırın. Ajanınız YoFont MCP sunucusunu kendisi kaydeder ve doğrular — elle düzenlenecek yapılandırma dosyası yok.
Anahtarınızı API sekmesindeki Kimlik doğrulama bölümünden alın.
MCP istemcinizi şuraya yöneltin: https://yofont.com/api/public/mcp. Streamable HTTP taşıması (JSON yanıt kipi) konuşur — çağrı başına bir JSON-RPC 2.0 isteği, açık tutulacak oturum ya da soket yok.
| Taşıma | Streamable HTTP (POST üzerinden JSON-RPC 2.0). Yöntemler: initialize, ping, tools/list, tools/call. |
| Kimlik doğrulama | REST API ile aynı API anahtarı — her istekte başlık olarak gönderin: Authorization: Bearer yf_live_.... |
Beş araç, API sekmesindeki REST uç noktalarıyla birebir — MCP'de düz REST'te de olmayan hiçbir şey yok.
Bir açıklamadan ve/veya referans görselden sıfırdan bir yazı ailesi üretir. Hemen bir izleme bağlantısıyla döner — bu eşzamansız bir iştir, bloklayan bir çağrı değil.
| prompt | Sade dille üslup açıklaması. reference_image_url verilirse isteğe bağlıdır. |
| reference_image_url | Doğrudan, herkese açık görsel adresi — yalnızca çağrı anında herkese açık şekilde çekilebilir olması yeterlidir. |
| languages, weights, glyph_types, model_tier | REST uç noktasıyla aynı biçim ve varsayılanlar — API sekmesinin Font oluştur bölümüne bakın. |
Bir font işinin kurulum ilerlemesini izler. Hazır olduğunda ttf/otf/woff/woff2 dosya adreslerini döndürür. Not: bunlar herkese açık şekilde çekilemez (403) — baytları almak için download_font aracını kullanın.
| linkzorunlu | generate_font'un döndürdüğü font bağlantısı. |
Font dosyasının baytlarını MCP kaynağı olarak doğrudan getirir; böylece ajanınız onu projenizde diske yazabilir. Dosya alışılmadık ölçüde büyükse düz bir adrese geri döner.
| linkzorunlu | generate_font'un döndürdüğü font bağlantısı. |
| format | ttf · otf · woff · woff2 — default ttf. |
Desteklenen tüm ISO-2 dil kodlarını glif sayıları ve metin yönüyle listeler — geçerli bir languages dizisi kurmak için kullanın.
Son 100 font işinizi listeler — durum, model, kaynak ve her fontun sayfasına bir bağlantı.
MCP araçları ancak arkalarındaki açıklama kadar iyidir. Bunlar tutarlı biçimde güçlü sonuçlar verir:
“Bir çocuk eğitim uygulaması için sıcak, yuvarlak hatlı bir sans-serif üret; İngilizce ve İspanyolca, normal ve bold ağırlıklar — sonra ttf dosyalarını ./public/fonts içine kaydet.”
Havayı, dilleri, ağırlıkları ve sonucun nereye konacağını söylüyor — ajan tüm döngüyü gözetimsiz çalıştırabilir.
“İşte eski logomuzun ekran görüntüsü: https://example.com/logo.png — üslubuna uyan bir display font üret, ultra kalitede, yalnızca İngilizce.”
Var olan belirli bir görünümü yakalamakta referans görseller sıfatları geride bırakır — başlık/display yazıda model_tier: ultra buna değer.
“8WeheWlTl fontunun durumunu denetle ve hazır olduğunda bana söyle, sonra woff2 adresini ver.”
Basit bir izle-ve-bildir — konuşmanın başında başlattığınız bir işi denetlemek için iyidir.
“YoFont hangi Kiril ve Yunan dillerini destekliyor? Rusça, Ukraynaca ve Yunanca'yı kapsayan bir font lazım.”
Ajanın ISO kodlarını ezberden tahmin etmesi yerine list_languages'i çağırmasını sağlar — yanlış yazılmış bir kod yüzünden başarısız bir generate_font çağrısını önler.
“Bu referans görselden geometrik bir display font üret, bitmesini bekle, sonra ttf'yi indir ve Tailwind yapılandırmamıza özel bir font-face olarak ekle.”
Üç aracı tek bir yönergede zincirler — üret → izle → indir — ve ajana somut bir sonraki adım verir.
“Tüm fontlarımı göster ve hangilerinin hâlâ sırada olduğunu ya da başarısız olduğunu söyle.”
Paneli açmadan bütün bir proje genelinde durum taraması yapmak için iyidir.
Sizden gelen tek bir istek tüm hattı tetikleyebilir — izleme döngüsünü ajanınız yürütür, siz yalnızca sonucu görürsünüz.