Hãy tạo phông chữ, lấy ký tự và quản lý việc phân phối bằng mã. Cùng một bộ máy với ứng dụng, chỉ cách một bearer token.
Mọi yêu cầu đều dùng một bearer token trong header Authorization. Hãy giữ nó ở phía máy chủ.
Hãy đăng nhập để tạo một khóa API thật — quyền truy cập API và MCP đã có sẵn trong các gói Pro và Studio.
Đăng nhập để lấy khóa của bạnYêu cầu được giới hạn theo từng khóa API. Vượt giới hạn sẽ nhận về 429 Too Many Requests kèm một Retry-After. Giới hạn tăng theo gói của bạn:
| Tạo phông chữ · mọi thứ còn lại | |
| Pro | 200 · 2 000 / phút |
| Studio | 600 · 6 000 / phút |
Cần thông lượng cao hơn? Hãy nâng cấp gói của bạn.
Tạo trọn một họ phông chữ từ câu mô tả và/hoặc một ảnh mẫu. Trả về một tác vụ để bạn theo dõi cho tới khi hoàn tất.
| promptbắt buộc | Mô tả bộ chữ bằng lời thường ngày. Optional when reference_image_url is set. |
| reference_image_url | Ảnh mẫu phong cách (PNG/JPG/WEBP) — một địa chỉ công khai trực tiếp. Chúng tôi không bao giờ lưu nó; chúng tôi chuyển tiếp liên kết nguyên trạng tới bộ máy dựng phông, giống như tính năng ảnh màn hình thành phông chữ của plugin Figma/Chrome. |
| languages | Mảng các mã ISO — mặc định là ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | ví dụ ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Lấy trạng thái và các địa chỉ tải về của một phông chữ (TTF / WOFF2 / phông biến thiên).
Tải tệp phông chữ đã dựng ở một định dạng cụ thể (ttf/otf/woff/woff2) — đúng tệp mà nút tải về trong Studio tạo ra.
Mọi mã ngôn ngữ ISO-2 được hỗ trợ, kèm số ký tự theo từng hệ chữ viết và hướng viết — dùng nó để dựng một mảng "languages" hợp lệ.
100 tác vụ phông chữ gần nhất của bạn — trạng thái, mô hình, nguồn và liên kết tới trang của từng phông chữ.
Việc tạo phông là bất đồng bộ. Sau khi POST tới generate, hãy theo dõi GET /api/public/status?link=… cách vài giây một lần cho tới khi trạng thái là font_ready (hoặc failed).
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — đã dựng xong bao nhiêu atlas ký tự |
| fonts | các địa chỉ tệp ttf/otf/woff/woff2, có mặt ngay khi status = font_ready. Những địa chỉ này cần khóa API của bạn — truy cập mà không có header Authorization sẽ nhận về 403. Hãy tải nội dung tệp qua GET /api/public/download?link=…&format=…. |
Theo dõi mỗi 3–5 giây là quá đủ — một họ phông đầy đủ thường xong trong chưa tới hai phút. Hãy tải các tệp qua GET /api/public/download kèm khóa API của bạn; các địa chỉ trong "fonts" không truy cập công khai được.
Mọi lỗi đều theo cùng một cấu trúc JSON: { "success": false, "error": "…" }.
| 400 | Yêu cầu không hợp lệ — thiếu trường hoặc trường không hợp lệ. Hãy kiểm tra error để biết chi tiết. |
| 401 | Chưa được xác thực — thiếu hoặc sai Authorization header. |
| 402 | Cần thanh toán — đã hết hạn mức ký tự. Hãy nạp thêm trên trang Các gói. |
| 403 | Bị từ chối — liên kết này thuộc về tài khoản khác. |
| 404 | Không tìm thấy — ID phông chữ không tồn tại hoặc thuộc về tài khoản khác. |
| 429 | Quá nhiều yêu cầu — đã chạm giới hạn tần suất. Hãy thử lại sau Retry-After. |
| 500 | Lỗi nội bộ — có trục trặc ở phía chúng tôi. Thử lại sau vài giây thường là được. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) cho phép các trợ lý lập trình AI — Claude Code, Cursor, Codex và những công cụ khác — gọi thẳng YoFont ngay trong lúc làm việc: tạo một phông chữ giữa cuộc trò chuyện, chờ nó dựng xong, rồi thả tệp thẳng vào dự án của bạn. Không phải sao chép — dán lệnh curl nào cả.
Mỗi lần gọi công cụ MCP đều là một lớp vỏ mỏng và minh bạch bọc quanh chính các endpoint REST được mô tả ở tab API — cùng cách xác thực, cùng giới hạn tần suất, cùng quy tắc kiểm tra. Không có gì máy chủ MCP làm mà lại bị giấu khỏi tài liệu REST.
Hãy sao chép câu lệnh bên dưới rồi dán vào Claude Code, Cursor hoặc Codex. Trợ lý của bạn sẽ tự đăng ký máy chủ MCP của YoFont và tự kiểm tra lại — không phải sửa tệp cấu hình nào bằng tay.
Hãy lấy khóa của bạn ở mục Xác thực trong tab API.
Hãy trỏ ứng dụng MCP của bạn tới https://yofont.com/api/public/mcp. Nó dùng lớp truyền Streamable HTTP (chế độ phản hồi JSON) — mỗi lần gọi là một yêu cầu JSON-RPC 2.0, không phải giữ phiên hay socket nào.
| Lớp truyền | Streamable HTTP (JSON-RPC 2.0 qua POST). Các phương thức: initialize, ping, tools/list, tools/call. |
| Xác thực | Cùng một khóa API như REST API — hãy gửi nó trong header ở mọi yêu cầu: Authorization: Bearer yf_live_.... |
Năm công cụ, tương ứng một đối một với các endpoint REST ở tab API — không có gì trong MCP mà lại không có ở REST thuần.
Tạo một họ phông chữ hoàn toàn mới từ câu mô tả và/hoặc một ảnh mẫu. Trả về ngay lập tức kèm một liên kết để theo dõi — đây là tác vụ bất đồng bộ, không phải lời gọi chờ kết quả.
| prompt | Mô tả phong cách bằng lời thường ngày. Không bắt buộc nếu đã có reference_image_url. |
| reference_image_url | Địa chỉ ảnh công khai trực tiếp — chỉ cần tải về công khai được tại thời điểm gọi. |
| languages, weights, glyph_types, model_tier | Cùng cấu trúc và giá trị mặc định như endpoint REST — xem mục Tạo phông chữ ở tab API. |
Theo dõi tiến trình dựng của một tác vụ phông chữ. Khi xong, trả về các địa chỉ tệp ttf/otf/woff/woff2. Lưu ý: những địa chỉ này không tải công khai được (403) — hãy dùng công cụ download_font để lấy nội dung tệp.
| linkbắt buộc | Liên kết phông chữ mà generate_font trả về. |
Lấy nội dung tệp phông chữ dưới dạng tài nguyên MCP, để trợ lý của bạn ghi thẳng vào đĩa trong dự án. Nếu tệp quá lớn, nó chuyển sang trả về một địa chỉ thông thường.
| linkbắt buộc | Liên kết phông chữ mà generate_font trả về. |
| format | ttf · otf · woff · woff2 — default ttf. |
Liệt kê mọi mã ngôn ngữ ISO-2 được hỗ trợ kèm số ký tự và hướng viết — dùng nó để dựng một mảng languages hợp lệ.
100 tác vụ phông chữ gần nhất của bạn — trạng thái, mô hình, nguồn và liên kết tới trang của từng phông chữ.
Công cụ MCP chỉ tốt bằng câu lệnh đứng sau nó. Những câu sau cho kết quả tốt một cách ổn định:
"Hãy tạo một phông sans-serif bo tròn, thân thiện cho ứng dụng giáo dục trẻ em, tiếng Anh và tiếng Tây Ban Nha, độ đậm normal và bold — rồi lưu các tệp ttf vào ./public/fonts."
Nêu rõ tinh thần, ngôn ngữ, độ đậm và nơi đặt kết quả — trợ lý chạy trọn vòng lặp mà không cần bạn can thiệp.
"Đây là ảnh chụp logo cũ của chúng tôi: https://example.com/logo.png — hãy tạo một phông display khớp với phong cách đó, chất lượng ultra, chỉ tiếng Anh."
Ảnh mẫu hiệu quả hơn tính từ khi cần bám sát một dáng chữ cụ thể đã có — model_tier: ultra rất đáng dùng cho chữ tiêu đề và display.
"Hãy kiểm tra trạng thái phông chữ 8WeheWlTl và báo cho tôi khi nó xong, rồi đưa tôi địa chỉ woff2."
Một lần theo dõi và báo cáo đơn giản — hợp để kiểm tra một tác vụ bạn đã khởi động trước đó trong cuộc trò chuyện.
"YoFont hỗ trợ những ngôn ngữ Kirin và Hy Lạp nào? Tôi cần một phông chữ phủ tiếng Nga, tiếng Ukraina và tiếng Hy Lạp."
Hãy để trợ lý gọi list_languages thay vì đoán mã ISO theo trí nhớ — tránh một lần gọi generate_font thất bại chỉ vì gõ sai mã.
"Hãy tạo một phông display hình học từ ảnh mẫu này, chờ cho xong, rồi tải tệp ttf về và thêm nó vào cấu hình Tailwind của chúng tôi dưới dạng font-face tùy chỉnh."
Nối cả ba công cụ trong một chỉ dẫn — tạo → theo dõi → tải về — và giao cho trợ lý một bước tiếp theo cụ thể.
"Hãy cho tôi xem tất cả phông chữ của mình và nói xem phông nào còn trong hàng đợi hoặc đã thất bại."
Hợp để rà soát trạng thái toàn bộ dự án mà không cần mở bảng điều khiển.
Một yêu cầu từ bạn có thể kích hoạt cả dây chuyền — trợ lý lo vòng lặp theo dõi, còn bạn chỉ thấy kết quả.