Jana fon, ambil glif dan urus penghantaran secara berprogram. Enjin yang sama seperti aplikasi, cuma satu token bearer jaraknya.
Semua permintaan menggunakan token bearer dalam pengepala Authorization. Simpannya di bahagian pelayan.
Log masuk untuk menjana kunci API langsung — akses API & MCP disertakan dengan pelan Pro dan Studio.
Log masuk untuk mendapatkan kunci andaPermintaan dihadkan bagi setiap kunci API. Melebihi had akan mengembalikan 429 Too Many Requests dengan satu Retry-After. Had berskala mengikut pelan anda:
| Cipta fon · selebihnya | |
| Pro | 200 · 2 000 / min |
| Studio | 600 · 6 000 / min |
Perlukan lebih banyak kapasiti? Naik taraf pelan anda.
Jana keluarga fon yang lengkap daripada arahan teks dan/atau imej rujukan. Ia mengembalikan satu kerja yang anda semak sehingga siap.
| promptwajib | Penerangan muka taip dalam bahasa biasa. Optional when reference_image_url is set. |
| reference_image_url | Imej rujukan gaya (PNG/JPG/WEBP) — satu URL awam yang terus. Kami tidak pernah menyimpannya; kami menghantar pautan itu seadanya ke enjin render, sama seperti tangkap-layar-jadi-fon pada pemalam Figma/Chrome. |
| languages | Tatasusunan kod ISO — lalai kepada ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | cth. ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Ambil status fon dan URL muat turunnya (TTF / WOFF2 / variable).
Muat turun fail fon yang telah dibina dalam format tertentu (ttf/otf/woff/woff2) — fail yang sama seperti yang dihasilkan butang muat turun Studio.
Setiap kod bahasa ISO-2 yang disokong, lengkap dengan bilangan glif bagi setiap sistem tulisan dan arah teks — gunakannya untuk membina tatasusunan "languages" yang sah.
100 kerja fon terakhir anda — status, model, sumber dan pautan ke halaman setiap fon.
Penjanaan adalah tak segerak. Selepas POST ke generate, semak GET /api/public/status?link=… setiap beberapa saat sehingga statusnya font_ready (atau failed).
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — berapa banyak atlas glif sudah siap |
| fonts | URL fail ttf/otf/woff/woff2, hadir setelah status = font_ready. URL ini memerlukan kunci API anda — mengambilnya tanpa pengepala Authorization akan mengembalikan 403. Muat turun baitnya melalui GET /api/public/download?link=…&format=…. |
Semakan setiap 3–5 saat sudah memadai — satu keluarga penuh biasanya siap dalam masa kurang daripada beberapa minit. Ambil failnya melalui GET /api/public/download dengan kunci API anda; URL dalam "fonts" tidak boleh diakses secara awam.
Semua ralat mengikut bentuk JSON yang konsisten: { "success": false, "error": "…" }.
| 400 | Permintaan tidak sah — medan hilang atau tidak sah. Semak error untuk butiran. |
| 401 | Tidak dibenarkan — hilang atau tidak sah Authorization pengepala. |
| 402 | Pembayaran diperlukan — kuota glif habis. Tambah nilai di halaman Pelan. |
| 403 | Dilarang — pautan itu milik akaun lain. |
| 404 | Tidak dijumpai — ID fon itu tidak wujud atau milik akaun lain. |
| 429 | Terlalu banyak permintaan — had kadar dicapai. Cuba semula selepas Retry-After. |
| 500 | Ralat dalaman — ada sesuatu yang tidak kena di pihak kami. Mencuba semula selepas beberapa saat biasanya berjaya. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) membolehkan ejen pengekodan AI — Claude Code, Cursor, Codex dan lain-lain — memanggil YoFont secara terus semasa mereka bekerja: menjana fon di tengah perbualan, menunggu ia siap dibina, dan meletakkan failnya terus ke dalam projek anda. Tanpa menyalin-tampal arahan curl.
Setiap panggilan alat MCP ialah pembalut nipis dan telus di atas titik akhir REST yang sama seperti yang didokumenkan pada tab API — pengesahan sama, had kadar sama, pengesahan data sama. Tiada apa yang dilakukan pelayan MCP tersembunyi daripada dokumentasi REST.
Salin arahan di bawah dan tampalkannya ke dalam Claude Code, Cursor atau Codex. Ejen anda mendaftarkan sendiri pelayan MCP YoFont dan mengesahkannya — tiada fail konfigurasi untuk disunting dengan tangan.
Dapatkan kunci anda dari bahagian Pengesahan pada tab API.
Halakan klien MCP anda ke https://yofont.com/api/public/mcp. Ia bertutur dalam pengangkutan Streamable HTTP (mod respons JSON) — satu permintaan JSON-RPC 2.0 bagi setiap panggilan, tiada sesi/soket untuk dibiarkan terbuka.
| Pengangkutan | Streamable HTTP (JSON-RPC 2.0 melalui POST). Kaedah: initialize, ping, tools/list, tools/call. |
| Pengesahan | Kunci API yang sama seperti API REST — hantarkannya sebagai pengepala pada setiap permintaan: Authorization: Bearer yf_live_.... |
Lima alat, satu lawan satu dengan titik akhir REST pada tab API — tiada apa dalam MCP yang bukan juga REST biasa.
Jana keluarga fon baharu daripada arahan dan/atau imej rujukan. Ia kembali serta-merta dengan pautan untuk disemak — ini kerja tak segerak, bukan panggilan yang menyekat.
| prompt | Penerangan gaya dalam bahasa biasa. Pilihan jika reference_image_url diberikan. |
| reference_image_url | URL imej awam yang terus — ia cuma perlu boleh diambil secara awam pada masa panggilan. |
| languages, weights, glyph_types, model_tier | Bentuk dan nilai lalai yang sama seperti titik akhir REST — lihat bahagian Cipta fon pada tab API. |
Semak kemajuan binaan sesuatu kerja fon. Sebaik siap, ia mengembalikan URL fail ttf/otf/woff/woff2. Nota: URL itu tidak boleh diambil secara awam (403) — guna alat download_font untuk mendapatkan baitnya.
| linkwajib | Pautan fon yang dikembalikan oleh generate_font. |
Ambil bait fail fon secara sebaris sebagai sumber MCP, supaya ejen anda boleh menulisnya terus ke cakera dalam projek anda. Ia berundur kepada URL biasa jika failnya luar biasa besar.
| linkwajib | Pautan fon yang dikembalikan oleh generate_font. |
| format | ttf · otf · woff · woff2 — default ttf. |
Senaraikan setiap kod bahasa ISO-2 yang disokong lengkap dengan bilangan glif dan arah teks — gunakannya untuk membina tatasusunan languages yang sah.
Senaraikan 100 kerja fon terakhir anda — status, model, sumber dan pautan ke halaman setiap fon.
Alat MCP hanya sebaik arahan di sebaliknya. Yang berikut memberi hasil yang kukuh secara konsisten:
“Jana sans-serif bulat yang mesra untuk aplikasi pendidikan kanak-kanak, dalam bahasa Inggeris dan Sepanyol, berat normal dan bold — kemudian simpan fail ttf ke dalam ./public/fonts.”
Menyebut suasananya, bahasanya, beratnya, dan di mana hasilnya perlu diletakkan — ejen boleh menjalankan keseluruhan gelung tanpa diawasi.
“Ini tangkap layar logo lama kami: https://example.com/logo.png — jana fon display yang sepadan dengan gayanya, kualiti ultra, bahasa Inggeris sahaja.”
Imej rujukan mengatasi kata sifat untuk memadankan rupa sedia ada yang khusus — model_tier: ultra berbaloi untuk muka taip hero/display.
“Semak status fon 8WeheWlTl dan beritahu saya bila ia siap, kemudian berikan saya URL woff2.”
Semakan dan laporan yang ringkas — baik untuk menyemak kerja yang anda mulakan lebih awal dalam perbualan.
“Bahasa Cyril dan Yunani apa yang disokong YoFont? Saya perlukan fon yang melindungi bahasa Rusia, Ukraine dan Yunani.”
Biarkan ejen memanggil list_languages dan bukannya meneka kod ISO daripada ingatan — mengelakkan panggilan generate_font yang gagal kerana kod tersalah taip.
“Jana fon display geometri daripada imej rujukan ini, tunggu sehingga siap, kemudian muat turun ttf dan tambahkannya ke konfigurasi Tailwind kami sebagai font-face tersuai.”
Merantai ketiga-tiga alat dalam satu arahan — jana → semak → muat turun — dan memberi ejen satu langkah seterusnya yang konkrit.
“Tunjukkan semua fon saya dan beritahu yang mana masih dalam giliran atau gagal.”
Baik untuk imbasan status merentas keseluruhan projek tanpa membuka papan pemuka.
Satu permintaan daripada anda boleh mencetuskan keseluruhan talian paip — ejen anda menguruskan gelung semakan, anda cuma melihat hasilnya.