Şriftleri dörediň, glifleri alyň we eltilmegini kod arkaly dolandyryň. Programmadaky şol bir hereketlendiriji, diňe bir bearer-token gerek.
Ähli haýyşlar bearer-tokeni şu ýerde ulanýar: Authorization — sözbaşy. Ony serwer tarapynda saklaň.
Işjeň API açaryny döretmek üçin hasaba giriň — API we MCP elýeterliligi Pro we Studio nyrhnamalaryna girýär.
Açar almak üçin hasaba giriňHaýyşlar her API açary boýunça çäklendirilýär. Çäkden geçseňiz, şu gaýtarylýar: 429 Too Many Requests şu bilen: Retry-After. Çäkler nyrhnamaňyza görä ulalýar:
| Şrift döretmek · galanlary | |
| Pro | 200 · 2 000 / min |
| Studio | 600 · 6 000 / min |
Has köp geçirijilik gerekmi? Nyrhnamaňyzy ýokarlandyryň.
Ýazgy görkezmesinden we/ýa-da nusga suratdan doly şrift maşgalasyny dörediň. Tamamlanmagyny soralýan tabşyryk gaýtarýar.
| prompthökmany | Şriftiň ýönekeý sözler bilen beýany. Optional when reference_image_url is set. |
| reference_image_url | Äheň üçin nusga surat (PNG/JPG/WEBP) — göni açyk URL. Biz ony hiç haçan saklamaýarys; salgyny şol durşuna çekiş hereketlendirijisine geçirýäris — Figma/Chrome plaginleriniň «ekran suratyndan şrift» işi ýaly. |
| languages | ISO kodlaryň massiwi — deslapky bahasy ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | meselem, ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
Şriftiň ýagdaýyny we göçürip almak salgylaryny alyň (TTF / WOFF2 / üýtgeýän).
Ýygnalan şrift faýlyny belli bir formatda göçürip alyň (ttf/otf/woff/woff2) — Studiýadaky göçürip almak düwmesiniň berýän faýlynyň şol bir özi.
Goldanylýan ähli ISO-2 dil kodlary, ýazuw ulgamy boýunça glif sanlary we ýazgynyň ugry — dogry "languages" massiwini düzmek üçin peýdalanyň.
Soňky 100 şrift tabşyrygyňyz — ýagdaýy, modeli, çeşmesi we her şriftiň sahypasyna salgy.
Döretmek asinhron. generate-e POST edeniňizden soň, şuny soraň: GET /api/public/status?link=… ýagdaý font_ready (ýa-da failed) bolýança her birnäçe sekuntdan.
| status | queued · processing · atlas_ready · font_ready · failed |
| progress | { total, completed, failed } — näçe glif atlasy taýýar |
| fonts | ttf/otf/woff/woff2 faýl salgylary, şundan soň peýda bolýar: status = font_ready. Bu salgylar API açaryňyzy talap edýär — Authorization sözbaşysyz alsaňyz, 403 gaýdýar. Faýlyň özüni şular arkaly göçürip alyň: GET /api/public/download?link=…&format=…. |
Her 3–5 sekuntdan bir sorag ýeterlik — doly maşgala adatça birnäçe minutdan az wagtda gutarýar. Faýllary API açaryňyz bilen GET /api/public/download arkaly alyň; "fonts" bölümindäki salgylar köpçülige elýeterli däl.
Ähli ýalňyşlyklar birmeňzeş JSON görnüşinde gelýär: { "success": false, "error": "…" }.
| 400 | Nädogry haýyş — meýdanlar ýok ýa-da nädogry. Serediň: error — jikme-jiklikler. |
| 401 | Rugsat berilmedi — ýok ýa-da nädogry Authorization sözbaşy. |
| 402 | Töleg gerek — glif çägi gutardy. Nyrhnamalar sahypasynda dolduryň. |
| 403 | Gadagan — salgy başga hasaba degişli. |
| 404 | Tapylmady — şriftiň ID-si ýok ýa-da başga hasaba degişli. |
| 429 | Haýyş örän köp — haýyş çägine ýetildi. Gaýtadan synanyşyň: Retry-After. |
| 500 | Içki ýalňyşlyk — biziň tarapymyzda bir zat ters gitdi. Birnäçe sekuntdan gaýtadan synanyşmak adatça kömek edýär. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP (Model Context Protocol) EA kod agentlerine — Claude Code, Cursor, Codex we beýlekilere — işläp otyrkalar YoFont-y göni çagyrmaga mümkinçilik berýär: söhbetdeşligiň ortasynda şrift döredip, ýygnalmagyna garaşyp, faýly göni taslamaňyza goşup bolýar. curl buýruklaryny göçürip geçirmek gerek däl.
Her MCP gural çagyryşy API goşmaça sahypasynda beýan edilen şol bir REST endpointleriň üstünden inçe we aç-açan gatlakdyr — şol bir tanamak, şol bir çäkler, şol bir barlag. MCP serweriniň edýän hiç bir işi REST resminamalaryndan gizlin däl.
Aşakdaky görkezmäni göçüriň-de, Claude Code, Cursor ýa-da Codex-e geçiriň. Agentiňiz YoFont MCP serwerini özi hasaba alýar we barlaýar — el bilen düzedilmeli konfig faýly ýok.
Açaryňyzy API goşmaça sahypasyndaky «Tanamak» böleginden alyň.
MCP müşderiňizi şu salga gönükdiriň: https://yofont.com/api/public/mcp. Ol Streamable HTTP geçirişini ulanýar (JSON jogap tertibi) — her çagyryşa bir JSON-RPC 2.0 haýyşy, açyk saklanmaly sessiýa ýa-da soket ýok.
| Geçiriş | Streamable HTTP (POST üsti bilen JSON-RPC 2.0). Usullar: initialize, ping, tools/list, tools/call. |
| Tanamak | REST API bilen şol bir API açary — ony her haýyşda sözbaşy hökmünde ugradyň: Authorization: Bearer yf_live_.... |
Bäş gural, API goşmaça sahypasyndaky REST endpointler bilen birme-bir — MCP-de plain REST-de bolmadyk hiç zat ýok.
Görkezmeden we/ýa-da nusga suratdan düýbünden täze şrift maşgalasyny dörediň. Ýagdaýy soramak üçin salgy bilen şobada gaýdýar — bu asinhron tabşyryk, garaşdyrýan çagyryş däl.
| prompt | Äheňiň ýönekeý sözler bilen beýany. reference_image_url berlen bolsa hökman däl. |
| reference_image_url | Göni açyk surat salgysy — çagyryş wagtynda köpçülige elýeterli bolmagy ýeterlik. |
| languages, weights, glyph_types, model_tier | REST endpointi bilen şol bir görnüş we deslapky bahalar — API goşmaça sahypasyndaky «Şrift döretmek» bölegine serediň. |
Şrift tabşyrygynyň ýygnalyş barşyny soraň. Taýýar bolanda ttf/otf/woff/woff2 faýl salgylaryny gaýtarýar. Bellik: olar köpçülige elýeterli däl (403) — faýlyň özüni almak üçin download_font guralyny ulanyň.
| linkhökmany | generate_font-yň gaýtaran şrift salgysy. |
Şrift faýlynyň baýtlaryny MCP resurs hökmünde göni alyň — şonda agentiňiz ony taslamaňyza gönüden-göni ýazyp biler. Faýl adatdan daşary uly bolsa, ýönekeý salgy gaýtarylýar.
| linkhökmany | generate_font-yň gaýtaran şrift salgysy. |
| format | ttf · otf · woff · woff2 — default ttf. |
Goldanylýan ähli ISO-2 dil kodlaryny glif sanlary we ýazgy ugry bilen sanaň — dogry languages massiwini düzmek üçin peýdalanyň.
Soňky 100 şrift tabşyrygyňyzy sanaň — ýagdaýy, modeli, çeşmesi we her şriftiň sahypasyna salgy.
MCP gurallary diňe olaryň aňyrsyndaky görkezme näderejede gowy bolsa, şonça gowy işleýär. Şular hemişe güýçli netije berýär:
«Çagalar üçin bilim programmasyna mähirli, tegelek sans-serif dörediň, iňlis we ispan dillerinde, normal we bold galyňlykda — soňra ttf faýllary ./public/fonts bukjasyna ýazyň.»
Äheňi, dilleri, galyňlyklary we netijäniň nirä ýazylmalydygyny aýdýar — agent tutuş işi gözegçiliksiz geçirip bilýär.
«Ine, biziň köne logotipimiziň ekran suraty: https://example.com/logo.png — şol äheňe gabat gelýän display şrift dörediň, ultra hilinde, diňe iňlis dilinde.»
Belli bir bar bolan görnüşi gaýtalamakda nusga suratlar sypatlardan güýçli — display şriftler üçin model_tier: ultra degýär.
«8WeheWlTl şriftiniň ýagdaýyny barlaň-da, taýýar bolanda maňa aýdyň, soňra woff2 salgysyny beriň.»
Ýönekeý «sora-da habar ber» — söhbetdeşligiň öňki böleginde başladan tabşyrygyňyzy barlamak üçin gowy.
«YoFont haýsy kiril we grek dillerini goldaýar? Maňa rus, ukrain we grek dillerini öz içine alýan şrift gerek.»
ISO kodlary ýatdan çaklamagyň ýerine agente list_languages çagyrtdyrýar — ýalňyş ýazylan kod sebäpli şowsuz generate_font çagyryşynyň öňüni alýar.
«Şu nusga suratdan geometrik display şrift dörediň, gutarmagyna garaşyň, soňra ttf-i göçürip alyň-da, ony Tailwind konfigimize ýörite font-face hökmünde goşuň.»
Bir görkezmede üç guraly baglaýar — döretmek → soramak → göçürip almak — hem-de agente anyk indiki ädim berýär.
«Ähli şriftlerimi görkeziň-de, haýsylarynyň heniz nobatdadygyny ýa-da şowsuz bolandygyny aýdyň.»
Dolandyryş panelini açmazdan tutuş taslama boýunça ýagdaýy gözden geçirmek üçin amatly.
Siziň bir haýyşyňyz tutuş zynjyry herekete getirip bilýär — agentiňiz soramak aýlawyny özi alyp barýar, siz diňe netijäni görýärsiňiz.