用程式碼生成字型、拉取字形、打理分發。和網頁版同一套引擎，一個 bearer token 就能接入。
每個請求都要在 Authorization 標頭裡帶上 bearer token，切記只放在服務端。
登入以生成 API 金鑰——API 與 MCP 訪問包含在 Pro 和 Studio 套餐中。
登入即可拿到你的金鑰請求限額按每個 API 金鑰單獨計算，超出後會返回 429 Too Many Requests ，並附帶 Retry-After. 限速隨套餐等級提升：
| 建立字型 · 其餘介面 | |
| Pro | 200 · 2 000 / 分鐘 |
| Studio | 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 這類 AI 程式設計助手能在工作過程中直接呼叫 YoFont：對話中途生成字型，等它構建完成，再把檔案直接放進你的專案 — 不用手動敲 curl 命令。
每一次 MCP 工具呼叫，本質上都只是 API 標籤頁裡那些 REST 介面的一層透明封裝 — 認證方式、限速規則、引數校驗完全一致。MCP 伺服器做的事，REST 文件裡都寫得清清楚楚。
複製下面的提示詞，貼上到 Claude Code、Cursor 或 Codex 裡。你的助手會自己註冊並驗證 YoFont 的 MCP 伺服器 — 不用手動改配置檔案。
在 API 標籤頁的「身份驗證」部分獲取你的金鑰。
把你的 MCP 客戶端指向 https://yofont.com/api/public/mcp. 走 Streamable HTTP 傳輸（JSON 響應模式）— 每次呼叫就是一個 JSON-RPC 2.0 請求，不需要維護會話或長連線。
| 傳輸方式 | Streamable HTTP（POST 上的 JSON-RPC 2.0）。方法：initialize、ping、tools/list、tools/call。 |
| 認證 | 和 REST API 用同一個金鑰 — 每次請求都作為請求頭帶上： Authorization: Bearer yf_live_.... |
一共五個工具，和 API 標籤頁上的 REST 介面一一對應 — 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 裡。"
把風格、語言、字重、存放位置都說清楚了 — 助手可以自己跑完整個流程，不用你盯著。
"這是我們舊 logo 的截圖：https://example.com/logo.png — 生成一款風格匹配的展示字型，質量選 ultra，只要英語。"
要還原一個具體的既有風格，參考圖比一堆形容詞管用得多 — 首屏/展示用的字型，model_tier: ultra 這個投入值得。
"幫我查一下字型 8WeheWlTl 的狀態，好了就告訴我，再把 woff2 連結給我。"
簡單的輪詢加彙報 — 適合用來檢視這次對話裡之前發起的任務。
"YoFont 支援哪些西裡爾字母和希臘語系的語言？我需要一款覆蓋俄語、烏克蘭語和希臘語的字型。"
讓助手呼叫 list_languages，而不是憑記憶瞎猜 ISO 程式碼 — 免得因為程式碼打錯字，導致 generate_font 呼叫失敗。
"根據這張參考圖生成一款幾何風格的展示字型，等它做完，下載 ttf，作為自定義 font-face 加到我們的 Tailwind 配置裡。"
一句話串起三個工具 — 生成 → 輪詢 → 下載 — 並且給了助手一個明確的下一步。
"把我所有的字型列出來，告訴我哪些還在排隊、哪些失敗了。"
不用開啟控制檯，就能對整個專案做一次狀態巡檢。
你只需要提一次需求，就能觸發整條流水線 — 輪詢迴圈全交給助手處理，你只用看結果。