API สร้างฟอนต์และเซิร์ฟเวอร์ MCP

// การยืนยันตัวตน

ทุกคำขอใช้ bearer token ในเฮดเดอร์ Authorization เก็บโทเคนไว้ฝั่งเซิร์ฟเวอร์เท่านั้น

เข้าสู่ระบบเพื่อสร้างคีย์ API ใช้งานจริง — การเข้าถึง API และ MCP รวมอยู่ในแพ็กเกจ Pro และ Studio

// ขีดจำกัดอัตราคำขอ

ระบบจำกัดคำขอต่อคีย์ API หากเกินขีดจำกัดจะได้รับ 429 Too Many Requests พร้อมกับ Retry-After. ขีดจำกัดเพิ่มขึ้นตามแพ็กเกจของคุณ:

	สร้างฟอนต์ · ส่วนที่เหลือทั้งหมด
Pro	200 · 2 000 / นาที
Studio	600 · 6 000 / นาที

ต้องการปริมาณมากขึ้นใช่ไหม? อัปเกรดแพ็กเกจของคุณ.

POST/api/public/generate

สร้างตระกูลฟอนต์ครบชุดจากข้อความพรอมต์และ/หรือรูปอ้างอิง ระบบจะคืนงานที่คุณต้องเรียกถามสถานะจนเสร็จ

promptจำเป็น	คำอธิบายตัวพิมพ์เป็นภาษาธรรมดา Optional when reference_image_url is set.
reference_image_url	รูปอ้างอิงสไตล์ (PNG/JPG/WEBP) — เป็น URL สาธารณะโดยตรง เราไม่เก็บรูปไว้ แต่ส่งลิงก์ต่อไปยังเอนจินเรนเดอร์ตามเดิม เช่นเดียวกับฟีเจอร์ภาพหน้าจอเป็นฟอนต์ในปลั๊กอิน 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).

200รับคำขอแล้ว — คืนค่า { success, link, task_id, glyphs_charged, status_url }

// Response JSON

402อักขระหมด — เติมยอดได้ที่หน้าแพ็กเกจ

GET/api/public/status?link=…

ดึงสถานะของฟอนต์และลิงก์ดาวน์โหลด (TTF / WOFF2 / variable)

// Request

// Response JSON

GET/api/public/download?link=…

ดาวน์โหลดไฟล์ฟอนต์ที่ประกอบเสร็จแล้วในรูปแบบที่ระบุ (ttf/otf/woff/woff2) — ไฟล์เดียวกับที่ปุ่มดาวน์โหลดใน Studio สร้างให้

// Request

// Response

GET/api/public/languages

รหัสภาษา ISO-2 ที่รองรับทั้งหมด พร้อมจำนวนอักขระแยกตามระบบการเขียนและทิศทางข้อความ — ใช้สร้างอาร์เรย์ "languages" ที่ถูกต้อง

// Request

// Response JSON

GET/api/public/fonts

งานสร้างฟอนต์ 100 รายการล่าสุดของคุณ — สถานะ โมเดล แหล่งที่มา และลิงก์ไปยังหน้าของแต่ละฟอนต์

// Request

// Response JSON

// การถามสถานะ

การสร้างเป็นแบบอะซิงโครนัส หลัง POST ไปที่ generate ให้เรียกถาม GET /api/public/status?link=… ทุกไม่กี่วินาทีจนกว่าสถานะจะเป็น font_ready (หรือ failed)

status	queued · processing · atlas_ready · font_ready · failed
progress	{ total, completed, failed } — จำนวนแอตลาสอักขระที่เสร็จแล้ว
fonts	ลิงก์ไฟล์ ttf/otf/woff/woff2 จะมีเมื่อ status = font_ready. ลิงก์เหล่านี้ต้องใช้คีย์ API ของคุณ หากดึงโดยไม่มีเฮดเดอร์ Authorization จะได้ 403 ให้ดาวน์โหลดตัวไฟล์ผ่าน GET /api/public/download?link=…&format=….

ถามสถานะทุก 3–5 วินาทีก็เพียงพอ — ตระกูลฟอนต์ครบชุดมักเสร็จภายในไม่ถึงสองนาที ดึงไฟล์ผ่าน GET /api/public/download ด้วยคีย์ API ของคุณ ลิงก์ในฟิลด์ "fonts" เข้าถึงแบบสาธารณะไม่ได้

// ข้อผิดพลาด

ข้อผิดพลาดทั้งหมดมีรูปแบบ JSON เดียวกัน: { "success": false, "error": "…" }.

400	คำขอไม่ถูกต้อง — ฟิลด์ขาดหายหรือไม่ถูกต้อง ตรวจสอบ error เพื่อดูรายละเอียด
401	ไม่ได้รับอนุญาต — ขาดหายหรือไม่ถูกต้อง: Authorization เฮดเดอร์
402	ต้องชำระเงินก่อน — โควตาอักขระหมดแล้ว เติมยอดได้ที่หน้าแพ็กเกจ
403	ไม่มีสิทธิ์เข้าถึง — ลิงก์นี้เป็นของบัญชีอื่น
404	ไม่พบ — ไม่มีรหัสฟอนต์นี้ หรือฟอนต์เป็นของบัญชีอื่น
429	คำขอมากเกินไป — ถึงขีดจำกัดอัตราแล้ว ลองใหม่หลังจาก Retry-After.
500	ข้อผิดพลาดภายใน — เกิดข้อผิดพลาดที่ฝั่งเรา ลองใหม่อีกครั้งหลังผ่านไปไม่กี่วินาทีมักจะใช้ได้

{
  "success": false,
  "error": "Not enough glyphs. Top up: https://yofont.com/plans"
}

การส่งข้อมูล	Streamable HTTP (JSON-RPC 2.0 ผ่าน POST) เมธอด: initialize, ping, tools/list, tools/call
การยืนยันตัวตน	ใช้คีย์ API เดียวกับ REST API — ส่งเป็นเฮดเดอร์ในทุกคำขอ: Authorization: Bearer yf_live_....

prompt	คำอธิบายสไตล์เป็นภาษาธรรมดา ไม่บังคับหากระบุ reference_image_url แล้ว
reference_image_url	URL รูปสาธารณะโดยตรง — ขอเพียงให้ดึงได้แบบสาธารณะในตอนที่เรียกใช้
languages, weights, glyph_types, model_tier	รูปแบบและค่าเริ่มต้นเหมือนเอนด์พอยต์ REST — ดูหัวข้อสร้างฟอนต์ในแท็บ API

linkจำเป็น	ลิงก์ฟอนต์ที่ generate_font คืนมา
format	ttf · otf · woff · woff2 — default ttf.

YoFont API/MCP

เข้าสู่ระบบ