Вход
Вход
Δημιουργήστε γραμματοσειρές, ανακτήστε glyphs και διαχειριστείτε την παράδοση προγραμματιστικά. Η ίδια μηχανή με την εφαρμογή — αρκεί ένα bearer token.
Όλα τα αιτήματα χρησιμοποιούν bearer token στην κεφαλίδα Authorization. Κρατήστε το μόνο στον διακομιστή σας.
Συνδεθείτε για να δημιουργήσετε ένα ενεργό κλειδί API — είναι δωρεάν, κάθε πλάνο περιλαμβάνει πρόσβαση στο API.
Συνδεθείτε για να λάβετε το κλειδί σαςΤα αιτήματα περιορίζονται ανά κλειδί API. Η υπέρβαση του ορίου επιστρέφει 429 Too Many Requests με μια Retry-After. Τα όρια κλιμακώνονται ανάλογα με το πλάνο σας:
| Δημιουργία γραμματοσειράς · όλα τα υπόλοιπα | |
| Starter | 60 · 600 / λεπτό |
| Pro | 200 · 2 000 / λεπτό |
| Agency | 600 · 6 000 / λεπτό |
Χρειάζεστε μεγαλύτερη απόδοση; Αναβαθμίστε το πλάνο σας.
Δημιουργήστε μια πλήρη οικογένεια γραμματοσειρών από μια περιγραφή σε απλά λόγια. Επιστρέφει μια εργασία της οποίας μπορείτε να παρακολουθείτε την πρόοδο ή να ειδοποιηθείτε μέσω webhook.
| promptαπαιτείται | Περιγραφή της γραμματοσειράς σε απλή γλώσσα. Optional when reference_image_url is set. |
| reference_image_url | Εικόνα αναφοράς στιλ (PNG/JPG/WEBP) — απευθείας δημόσιο URL. Δεν την αποθηκεύουμε ποτέ· προωθούμε τον σύνδεσμο αυτούσιο στη μηχανή απόδοσης, όπως ακριβώς και τα plugins Figma/Chrome στο screenshot-to-font. |
| 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). |
Ανακτήστε την κατάσταση μιας γραμματοσειράς και τα URL λήψης (TTF / WOFF2 / variable).
Κατεβάστε το τελικό αρχείο γραμματοσειράς σε συγκεκριμένη μορφή (ttf/otf/woff/woff2) — το ίδιο αρχείο που παράγει το κουμπί λήψης στο Studio.
Όλοι οι υποστηριζόμενοι κωδικοί γλώσσας ISO-2, με τον αριθμό glyphs ανά γραφικό σύστημα και την κατεύθυνση κειμένου — χρησιμοποιήστε τα για να φτιάξετε έναν έγκυρο πίνακα "languages".
Οι τελευταίες 100 εργασίες γραμματοσειρών σας — κατάσταση, μοντέλο, πηγή και σύνδεσμος προς τη σελίδα κάθε γραμματοσειράς.
Η δημιουργία είναι ασύγχρονη. Μετά το POST στο generate, ελέγχετε το GET /api/public/status?link=… κάθε λίγα δευτερόλεπτα μέχρι η κατάσταση να γίνει font_ready (ή failed).
| status | queued · processing · font_ready · failed |
| progress | { total, completed, failed } — πόσα glyph atlases έχουν ολοκληρωθεί |
| fonts | Απευθείας URLs ttf/otf/woff/woff2, παρόντα μόλις status = font_ready. |
Ένας έλεγχος κάθε 3–5 δευτερόλεπτα είναι αρκετός — μια πλήρης οικογένεια συνήθως ολοκληρώνεται σε λιγότερο από δύο λεπτά. Τα URLs των αρχείων γραμματοσειράς είναι στατικά και δεν απαιτούν έλεγχο ταυτότητας μόλις επιστραφούν.
Όλα τα σφάλματα επιστρέφονται με την ίδια δομή JSON: { "success": false, "error": "…" }.
| 400 | Εσφαλμένο αίτημα — λείπουν ή είναι άκυρα πεδία. Ελέγξτε το error για λεπτομέρειες. |
| 401 | Μη εξουσιοδοτημένο — λείπει ή είναι άκυρο το Authorization κεφαλίδα. |
| 402 | Απαιτείται πληρωμή — εξαντλήθηκε το όριο glyphs. Προσθέστε glyphs στη σελίδα Πλάνων. |
| 403 | Απαγορεύεται — ο σύνδεσμος ανήκει σε άλλον λογαριασμό. |
| 404 | Δεν βρέθηκε — το ID της γραμματοσειράς δεν υπάρχει ή ανήκει σε άλλον λογαριασμό. |
| 429 | Πάρα πολλά αιτήματα — φτάσατε το όριο αιτημάτων. Δοκιμάστε ξανά μετά από Retry-After. |
| 500 | Εσωτερικό σφάλμα — κάτι πήγε στραβά από τη δική μας πλευρά. Συνήθως αρκεί να ξαναδοκιμάσετε σε λίγα δευτερόλεπτα. |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
Το MCP (Model Context Protocol) επιτρέπει σε AI coding agents — Claude Code, Cursor, Codex και άλλους — να καλούν την YoFont απευθείας ενώ δουλεύουν: να δημιουργούν μια γραμματοσειρά μέσα στη συνομιλία, να περιμένουν να ολοκληρωθεί η δημιουργία και να τοποθετούν το αρχείο κατευθείαν στο project σας. Χωρίς αντιγραφή-επικόλληση εντολών curl.
Κάθε κλήση εργαλείου MCP είναι ένα λεπτό, διαφανές wrapper πάνω στα ίδια REST endpoints που τεκμηριώνονται στην καρτέλα API — ίδιος έλεγχος ταυτότητας, ίδια όρια αιτημάτων, ίδια επικύρωση. Τίποτα από όσα κάνει ο MCP server δεν κρύβεται από την τεκμηρίωση REST.
Αντιγράψτε το παρακάτω prompt και επικολλήστε το στο Claude Code, το Cursor ή το Codex. Ο agent σας καταχωρεί μόνος του τον MCP server της YoFont και τον επαληθεύει — χωρίς αρχεία config για χειροκίνητη επεξεργασία.
Πάρτε το κλειδί σας από την ενότητα «Έλεγχος ταυτότητας» στην καρτέλα API.
Κατευθύνετε τον MCP client σας στο https://yofont.com/api/public/mcp. Χρησιμοποιεί μεταφορά Streamable HTTP (λειτουργία απόκρισης JSON) — ένα αίτημα JSON-RPC 2.0 ανά κλήση, χωρίς session ή socket που να πρέπει να μείνει ανοιχτό.
| Μεταφορά | Streamable HTTP (JSON-RPC 2.0 πάνω από POST). Μέθοδοι: initialize, ping, tools/list, tools/call. |
| Εξουσιοδότηση | Το ίδιο κλειδί API με το REST API — στείλτε το ως κεφαλίδα σε κάθε αίτημα: Authorization: Bearer yf_live_.... |
Πέντε εργαλεία, ένα προς ένα αντίστοιχα με τα REST endpoints στην καρτέλα API — τίποτα στο MCP δεν υπάρχει που να μην υπάρχει και ως απλό REST.
Δημιουργήστε μια ολοκαίνουργια οικογένεια γραμματοσειρών από ένα prompt ή/και μια εικόνα αναφοράς. Επιστρέφει άμεσα έναν σύνδεσμο για έλεγχο κατάστασης — πρόκειται για ασύγχρονη εργασία, όχι για blocking κλήση.
| prompt | Περιγραφή στιλ σε απλή γλώσσα. Προαιρετικό αν έχει δοθεί reference_image_url. |
| reference_image_url | Απευθείας δημόσιο URL εικόνας — αρκεί να είναι προσβάσιμο δημόσια τη στιγμή της κλήσης. |
| languages, weights, glyph_types, model_tier | Ίδια δομή και προεπιλογές με το endpoint REST — δείτε την ενότητα «Δημιουργία γραμματοσειράς» στην καρτέλα API. |
Ελέγξτε την πρόοδο δημιουργίας μιας εργασίας γραμματοσειράς. Μόλις είναι έτοιμη, επιστρέφει απευθείας URLs ttf/otf/woff/woff2 — μπορείτε να τα ανακτήσετε απευθείας, χωρίς έλεγχο ταυτότητας.
| linkαπαιτείται | Ο σύνδεσμος γραμματοσειράς που επιστρέφει η generate_font. |
Ανακτήστε τα bytes ενός αρχείου γραμματοσειράς απευθείας ως πόρο (resource) MCP, ώστε ο agent σας να μπορεί να το γράψει κατευθείαν στον δίσκο μέσα στο project σας. Σε ασυνήθιστα μεγάλα αρχεία, επιστρέφεται απλό URL.
| linkαπαιτείται | Ο σύνδεσμος γραμματοσειράς που επιστρέφει η generate_font. |
| format | ttf · otf · woff · woff2 — default ttf. |
Λίστα όλων των υποστηριζόμενων κωδικών γλώσσας ISO-2 με αριθμό glyphs και κατεύθυνση κειμένου — χρησιμοποιήστε την για να φτιάξετε έναν έγκυρο πίνακα languages.
Λίστα με τις τελευταίες 100 εργασίες γραμματοσειρών σας — κατάσταση, μοντέλο, πηγή και σύνδεσμος προς τη σελίδα κάθε γραμματοσειράς.
Τα εργαλεία MCP είναι τόσο καλά όσο το prompt πίσω τους. Αυτά δίνουν σταθερά ισχυρά αποτελέσματα:
"Δημιούργησε μια φιλική, στρογγυλεμένη γραμματοσειρά sans-serif για μια εκπαιδευτική εφαρμογή παιδιών, στα αγγλικά και ισπανικά, σε κανονικό και έντονο βάρος — και αποθήκευσε τα αρχεία ttf στο ./public/fonts."
Καθορίζει τη διάθεση, τις γλώσσες, τα βάρη και πού να αποθηκευτεί το αποτέλεσμα — ο agent μπορεί να τρέξει ολόκληρο τον κύκλο χωρίς επίβλεψη.
"Ορίστε ένα screenshot του παλιού μας λογότυπου: https://example.com/logo.png — δημιούργησε μια γραμματοσειρά τίτλων που να ταιριάζει με το στιλ του, ποιότητα ultra, μόνο αγγλικά."
Οι εικόνες αναφοράς είναι πιο αποτελεσματικές από τα επίθετα όταν θέλετε να ταιριάξετε ένα συγκεκριμένο υπάρχον στιλ — το model_tier: ultra αξίζει για γραμματοσειρές τίτλων/hero.
"Έλεγξε την κατάσταση της γραμματοσειράς 8WeheWlTl και πες μου πότε θα είναι έτοιμη, μετά δώσε μου το URL του woff2."
Ένας απλός έλεγχος-και-αναφορά — ιδανικό για να παρακολουθείτε μια εργασία που ξεκινήσατε νωρίτερα στη συνομιλία.
"Ποιες κυριλλικές και ελληνικές γλώσσες υποστηρίζει η YoFont; Χρειάζομαι μια γραμματοσειρά που να καλύπτει ρωσικά, ουκρανικά και ελληνικά."
Αφήστε τον agent να καλέσει το list_languages αντί να μαντεύει κωδικούς ISO από μνήμης — αποφεύγετε μια αποτυχημένη κλήση generate_font λόγω λάθους στον κωδικό.
"Δημιούργησε μια γεωμετρική γραμματοσειρά τίτλων από αυτή την εικόνα αναφοράς, περίμενε να ολοκληρωθεί, μετά κατέβασε το ttf και πρόσθεσέ το στο Tailwind config μας ως custom font-face."
Συνδέει και τα τρία εργαλεία σε μία οδηγία — δημιουργία → έλεγχος κατάστασης → λήψη — και δίνει στον agent ένα συγκεκριμένο επόμενο βήμα.
"Δείξε μου όλες τις γραμματοσειρές μου και πες μου ποιες είναι ακόμη σε αναμονή ή απέτυχαν."
Ιδανικό για μια γρήγορη επισκόπηση κατάστασης σε όλο το project χωρίς να ανοίξετε το dashboard.
Ένα μόνο αίτημά σας μπορεί να ενεργοποιήσει ολόκληρο το pipeline — ο agent σας αναλαμβάνει τον βρόχο ελέγχου κατάστασης, εσείς βλέπετε μόνο το αποτέλεσμα.