YoFont — AI font generator
Хөгжүүлэгчид · REST v1

YoFont API/MCP

Фонт үүсгэ, глиф ав, хүргэлтийг програмаар удирд. Апп-тай ижил хөдөлгүүр, нэг bearer токены зайд.

// Баталгаажуулалт

Бүх хүсэлт дараах толгойд bearer токен ашиглана: Authorization. Түүнийг сервер талдаа хадгал.

Ажиллах API түлхүүр үүсгэхийн тулд нэвтэрнэ үү — API ба MCP хандалт Pro, Studio багцад багтсан.

// Хурдны хязгаар

Хүсэлтүүд API түлхүүр тус бүрээр хязгаарлагдана. Хязгаараас хэтэрвэл дараахыг буцаана: 429 Too Many Requests дараахтай хамт: Retry-After. Хязгаар нь таны багцын дагуу өснө:

Фонт үүсгэх · бусад бүхэн
Pro200 · 2 000 / мин
Studio600 · 6 000 / мин

Илүү их багтаамж хэрэгтэй юу? Багцаа дэвшүүл.

POST/api/public/generate

Текст тайлбар болон/эсвэл лавлах зургаас бүрэн фонтын гэр бүл үүсгэнэ. Дуусахыг нь хянах ажил буцаана.

promptзаавалҮсгийн загварын энгийн хэлээрх тайлбар. Optional when reference_image_url is set.
reference_image_urlХэв маягийн лавлах зураг (PNG/JPG/WEBP) — шууд нийтийн URL. Бид үүнийг хадгалдаггүй; холбоосыг байгаагаар нь зурах хөдөлгүүр рүү дамжуулна, Figma/Chrome залгаасын дэлгэцийн зургаас фонт үүсгэхтэй адил.
languagesISO кодуудын массив — өгөгдмөл нь ["en"]. Two-letter ISO codes, full list: GET /api/public/languages.
weightsжишээ нь ["normal","bold","thin"].
glyph_typesletters · digits · punct · special (default all).
model_tierstandard (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=…

Фонтын төлөв, татах URL-уудыг ав (TTF / WOFF2 / хувьсах).

// Request

                
// Response JSON

                
GET/api/public/download?link=…

Бүтээгдсэн фонт файлыг тодорхой форматаар (ttf/otf/woff/woff2) тат — Студийн татах товч гаргадаг яг тэр файл.

// Request

                
// Response

                
GET/api/public/languages

Дэмжигдсэн ISO-2 хэлний код бүр, бичиг тус бүрийн глифийн тоо, бичгийн чиглэлтэй — зөв "languages" массив бүрдүүлэхэд ашигла.

// Request

                
// Response JSON

                
GET/api/public/fonts

Сүүлийн 100 фонтын ажил — төлөв, загвар, эх сурвалж болон фонт бүрийн хуудасны холбоос.

// Request

                
// Response JSON

                
// Хяналт

Үүсгэлт асинхрон. generate руу POST хийсний дараа дараахыг хяна: GET /api/public/status?link=… төлөв font_ready (эсвэл failed) болтол хэдэн секунд тутам.

statusqueued · processing · atlas_ready · font_ready · failed
progress{ total, completed, failed } — хэдэн глифийн атлас дууссан
fontsttf/otf/woff/woff2 файлын URL-ууд, дараах үед гарна: status = font_ready. Эдгээр URL-д таны API түлхүүр шаардлагатай — Authorization толгойгүйгээр татахад 403 буцаана. Байтыг дараахаар тат: GET /api/public/download?link=…&format=….

3–5 секунд тутмын хяналт хангалттай — бүтэн гэр бүл ихэвчлэн хоёр минутаас доош хугацаанд дуусдаг. Файлуудыг API түлхүүрээрээ GET /api/public/download-аар ав; "fonts" доторх URL-ууд нийтэд нээлттэй биш.

// Алдаанууд

Бүх алдаа нэгдсэн 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"
}