Θέμα

Αναφορά OG Image API

Η αναφορά OG image API καλύπτει το endpoint, τις παραμέτρους και τον κατάλογο προτύπων για τη δημιουργία δυναμικών εικόνων Open Graph με το FastOG. Το API είναι διαθέσιμο μόνο με συνδρομή — απαιτείται ενεργό πρόγραμμα Dynamic API, αλλά οι ίδιες οι αποδόσεις δεν χρεώνονται με βάση τη χρήση: δεν υπάρχει μηνιαίο όριο αποδόσεων ούτε χρέωση υπέρβασης. Τα URLs με υπογραφή HMAC (HMAC-signed URLs) διατηρούν κάθε αίτημα ασφαλές. Εγγραφείτε, επιλέξτε ένα πρόγραμμα Dynamic API και στη συνέχεια δημιουργήστε το κλειδί API και το μυστικό HMAC σας στον πίνακα ελέγχου· οι πληρωμένες αποδόσεις API είναι καθαρές. Το παραγόμενο συμβόλαιο OpenAPI αποτελεί την έγκυρη μηχανικά αναγνώσιμη λίστα παραμέτρων, κωδικών σφάλματος και slugs προτύπων.

Βασικό URL

https://fastog.com/api/v1/og

Έλεγχος ταυτότητας

Όλα τα αιτήματα απαιτούν έλεγχο ταυτότητας με υπογραφή HMAC-SHA256. Το δημόσιο key και η υπογραφή s είναι παράμετροι ερωτήματος (query parameters)· ο έλεγχος ταυτότητας μέσω κεφαλίδας (header) δεν υποστηρίζεται προς το παρόν. Ανατρέξτε στην Τεκμηρίωση HMAC για λεπτομέρειες.

Endpoint

GET `/api/v1/og`

Δημιουργεί μια δυναμική εικόνα Open Graph με βάση τις παρεχόμενες παραμέτρους.

Παράμετροι ερωτήματος

Παράμετρος	Τύπος	Απαιτείται	Περιγραφή
`template`	string	Όχι	Όνομα προτύπου (προεπιλογή: `default`)
`title`	string	Ναι	Κύρια επικεφαλίδα. Απαιτείται — ένα εξώφυλλο χωρίς τίτλο δεν είναι χρήσιμη προεπισκόπηση.
`subtitle`	string	Όχι	Υπότιτλος ή κείμενο περιγραφής
`key`	string	Ναι	Πλήρες κλειδί API
`s`	string	Ναι	Υπογραφή HMAC-SHA256 (64 hex chars)

Παράμετροι ανά πρότυπο

Κάθε πρότυπο δέχεται τις κοινές παραμέτρους παρακάτω καθώς και τις παραμέτρους που αφορούν το συγκεκριμένο πρότυπο (δείτε τον πίνακα ευρετηρίου). Η παράμετρος ερωτήματος template επιλέγει ποια διάταξη χρησιμοποιείται (προεπιλογή: default).

Κοινές παράμετροι (όλα τα πρότυπα)

Παράμετρος	Τύπος	Περιγραφή
`title`	string	Κείμενο κύριας επικεφαλίδας
`subtitle`	string	Υποστηρικτικό κείμενο
`tags`	list	Ετικέτες χωρισμένες με κόμμα
`theme`	string	`dark` \| `light` \| `glass` \| `solid` \| `midnight` \| `vivid` \| `paper` \| `glass_light` \| `custom`
`gradient_preset`	string	Προεπιλογή με ονομασία gradient (π.χ. `indigo`, `ocean`, `sunset`, `cosmic`)
`gradient_direction`	number	Γωνία gradient σε μοίρες (προεπιλογή `135`)
`bg_color`	hex	Συμπαγές χρώμα φόντου
`pattern`	string	Μοτίβο φόντου (`grid`, `dots`, `noise`, `none`, …)
`pattern_color`	hex	Χρώμα μοτίβου
`pattern_intensity`	number	Αδιαφάνεια μοτίβου (1–30)
`font_family`	string	`font-sans`, `font-jakarta`, `font-dm`, `font-outfit`, `font-space`, `font-playfair`, `font-merriweather`, `font-instrument`, `font-jetbrains`, `font-fira`
`accent_color`	hex	Χρώμα έμφασης για επισημάνσεις
`auto_text_color`	bool	Παραγωγή χρώματος κειμένου από το φόντο (προεπιλογή `true`)
`title_color`	hex	Παράκαμψη χρώματος τίτλου
`subtitle_color`	hex	Παράκαμψη χρώματος υποτίτλου
`brand_name`	string	Κείμενο επωνυμίας/λογότυπου (προεπιλογή `FastOG`)
`brand_logo`	string	URL εικόνας λογότυπου επωνυμίας
`layout_mode`	string	`split` \| `centered` \| `banner` (ισχύουν παραλλαγές ανά πρότυπο)

Ευρετήριο προτύπων — 67 slugs με δυνατότητα απόδοσης, 48 επιλέξιμα. Ο παρακάτω πίνακας τεκμηριώνει τις πιο χρησιμοποιημένες εμφανίσεις και τις ιδιότητες (props) που αφορούν συγκεκριμένα πρότυπα· η εξαντλητική, παραγόμενη λίστα (label, κατηγορία, σημαία απόσυρσης και κάθε αποδεκτό slug) βρίσκεται στο /openapi.json στην ενότητα x-template-catalogue, και τα πεδία επεξεργασίας κάθε προτύπου (key, label, type, default, options και μορφή URL) βρίσκονται στην ενότητα x-template-fields. Τα αποσυρμένα slugs παραμένουν με δυνατότητα απόδοσης ώστε τα URLs που ήδη κυκλοφορούν να συνεχίσουν να λειτουργούν, αλλά δεν προσφέρονται από τους επιλογείς.

`template`	Πρότυπο	Κατηγορία	Πρόσθετες παράμετροι
`default`	Default	Brand	—
`blog`	Blog Post	Content	`author`, `date`, `domain`
`ecommerce`	E-commerce	Commerce	`price`, `original_price`, `rating`, `rating_total`, `features`, `badge`, `cta`, `image`, `domain`
`company`	Company	Brand	`domain`, `logo`, `tag`
`launch`	Product Launch	Brand	`kicker`, `version`, `tag`, `cta`, `domain`
`saaslaunch`	SaaS Launch	Brand	`kicker`, `cta`, `domain`
`devtool`	Developer Tool	Developer	`version`, `badge`, `domain`
`game`	Game	Content	`price`, `rating`, `image`, `domain`
`event`	Event	Social	`location`, `host`, `date`, `domain`
`quote`	Quote	Social	`quote`, `author_name`, `author_title`
`job`	Job Posting	Social	`location`, `department`, `salary`, `job_type`, `domain`
`stats`	Stats	Data	`metric`, `metric_label`, `delta`
`pricing`	Pricing	Commerce	`price`, `period`, `cta`
`podcast`	Podcast	Media	`episode_number`, `guest_name`, `guest_role`, `duration`
`video`	Video	Media	`duration`, `channel`, `views`
`editorial`	Editorial	Content	`kicker`, `author`, `date`, `domain`
`minimal`	Minimal	Brand	`domain`
`changelog`	Changelog	Developer	`version`, `tag`
`corporate`	Corporate	Brand	`kicker`, `tag`, `domain`
`hero`	Hero	Brand	`kicker`, `cta`, `status`, `domain`
`imageright`	Image Right	Commerce	`kicker`, `price`, `original_price`, `rating`, `rating_total`, `badge`, `cta`, `image`, `domain`
`specgrid`	Spec Grid	Commerce	`specs` (λίστα από `Label
`logos`	Logo Wall	Brand	`kicker`, `brand_logos`, `domain`
`notice`	Notice	Social	`notice_status`, `notice_icon`, `notice_text`, `date`, `domain`
`testimonial`	Testimonial	Social	`quote`, `author_name`, `author_title`, `company`, `author_avatar`, `rating`, `rating_total`, `quote_style`
`logofocus`	Logo Focus	Content	`kicker`, `domain`
`xheader`	X Header	Social	`size`, `handle`, `followers`, `location`, `website`, `avatar`
`bento`	Bento	Data	`kicker`, `tiles`, `domain`
`comparison`	Comparison	Commerce	`kicker`, `left_label`, `left_desc`, `left_points`, `right_label`, `right_desc`, `right_points`, `verdict`
`timeline`	Timeline	Content	`kicker`, `milestones`, `domain`
`countdown`	Countdown	Brand	`kicker`, `target_date`, `cta`, `domain`
`news`	News	Content	`headline`, `byline`, `author`, `date`, `source`, `image`
`code`	Code	Developer	`code`, `language`, `terminal_title`, `author`, `domain`
`testimonialpro`	Testimonial Pro	Social	`quote`, `author_name`, `author_title`, `company`, `author_avatar`, `rating`, `rating_total`, `cta`
`product`	Product	Commerce	`badge`, `title`, `price`, `original_price`, `rating`, `rating_total`, `features`, `cta`, `image`, `layout_mode`
`promo`	Promo	Brand	`brand_name`, `benefits`, `title`, `subtitle`, `domain`, `layout_mode`
`devblog`	Dev Blog	Content	`category`, `title`, `subtitle`, `tags`, `author`, `author_title`, `date`, `read_time`, `views`, `likes`, `comments`, `code`, `language`, `file_path`
`codepost`	Code Post	Content	`category`, `date`, `title`, `subtitle`, `author`, `read_time`, `code`, `file_path`, `language`
`statsbar`	Stats Bar	Data	`kicker`, `metric`, `metric_label`, `delta`, `stats`, `domain`
`changelogpro`	Changelog Pro	Developer	`version`, `tag`, `title`, `changes`, `features`, `domain`
`quotecta`	Quote CTA	Social	`quote`, `author_name`, `author_title`, `company`, `cta`, `domain`
`appscreenshot`	App Screenshot	Media	`badge`, `title`, `subtitle`, `app_name`, `rating`, `screenshot`, `domain`
`realestate`	Real Estate	Commerce	`title`, `subtitle`, `price`, `beds`, `baths`, `sqft`, `cta_text`, `status`, `image_url`, `domain`
`autorental`	Auto Rental	Commerce	`title`, `subtitle`, `rate_badge`, `cta_text`, `fleet_tag`, `image_url`, `domain`
`restaurant`	Restaurant	Commerce	`kicker`, `title`, `subtitle`, `price`, `cta_text`, `badge`, `image_url`, `domain`
`hospitality`	Hospitality	Media	`kicker`, `title`, `subtitle`, `rate`, `cta_text`, `image_url`, `domain`
`saasspend`	SaaS Spend	Brand	`status_pill`, `title`, `subtitle`, `cta_text`, `stat_callout`, `dashboard_image`, `domain`
`brutalist`	Brutalist	Brand	`agency_tag`, `title`, `subtitle`, `cta_text`, `footer_note`, `domain`
`training`	Training	Social	`track`, `dates`, `title`, `subtitle`, `cta_text`, `location`, `image_url`, `domain`
`ecosystem`	Ecosystem	Developer	`kicker`, `title`, `subtitle`, `apps_list`, `dock_label`, `domain`

Το glassproduct δέχεται επίσης cta. Τα πρότυπα ecommerce, product, glassproduct και imageright εμφανίζουν από προεπιλογή το «Shop now»· ορίστε το cta σε κενή τιμή για να αποκρύψετε το οπτικό χάπι.

Δομημένοι τύποι παραμέτρων

Τύπος	Μορφή	Παράδειγμα
`list`	Τιμές διαχωρισμένες με κόμμα	`features=Fast,Cheap,Secure`
`tiles`	Ζεύγη `label\|value` διαχωρισμένα ανά γραμμή	`tiles=Requests\|12.4M\nUptime\|99.99%`
`milestones`	`date\|title\|description` διαχωρισμένα ανά γραμμή	`milestones=Q3 2026\|Alpha\|Invite-only`
`changes`	`type\|text` διαχωρισμένα ανά γραμμή (`added`,`fixed`,`improved`,`removed`)	`changes=added\|Bento templates`

Απόκριση

200 OK — Επιστρέφει δεδομένα εικόνας PNG
401 Unauthorized — Μη έγκυρος ή απόν έλεγχος ταυτότητας
422 Unprocessable — Μη έγκυρες παράμετροι προτύπου

Αποκρίσεις σφάλματος

Κωδικός σφάλματος	Κατάσταση HTTP	Περιγραφή
`missing_signature`	401	Απουσιάζει η παράμετρος `key` ή `s`
`invalid_signature`	401	Η επαλήθευση υπογραφής απέτυχε

Παράδειγμα αιτήματος

GET /api/v1/og?template=blog&title=Hello%20World&subtitle=A%20test%20post&key=sk_quick_123abc&s=a1b2c3...

Παράδειγμα cURL

bash

curl "https://fastog.com/api/v1/og?template=blog&title=Hello%20World&key=sk_quick_123abc&s=<signature>"

Τιμολόγηση & Όρια

Το FastOG είναι με πρόσβαση βάσει συνδρομής: απαιτείται ενεργό πρόγραμμα Dynamic API. Οι αποδόσεις (renders) δεν μετρώνται — δεν υπάρχει μηνιαία ποσόστωση αποδόσεων ούτε χρέωση υπέρβασης. Το πρόγραμμα είναι η πύλη, και κάθε βαθμίδα αποδίδει χωρίς μετρητή. Δείτε την Τιμολόγηση για τις τρέχουσες βαθμίδες και τιμές.

Οι εικόνες από την προσωρινή μνήμη είναι δωρεάν: τα αιτήματα που εξυπηρετούνται από την προσωρινή μνήμη άκρου του Cloudflare (ίδιο πρότυπο + παράμετροι, ανεξάρτητα από την υπογραφή s σε ένα προηγουμένως αποθηκευμένο URL) δεν φτάνουν ποτέ στην προέλευση, οπότε ένα πανομοιότυπο URL δεν καταναλώνει άλλη απόδοση.

Καθαρό από προεπιλογή: κάθε απόδοση είναι καθαρή — χωρίς υδατογράφημα σε κανένα πρόγραμμα, και κανένα στο δωρεάν OG Image Tester, στις προεπισκοπήσεις του Studio ή στις εξαγωγές του Studio. Μια ιδιότητα απόδοσης fastog_watermark εξακολουθεί να υποστηρίζεται για καλούντες που ζητούν ρητά ένα σήμα "Made with FastOG", αλλά τίποτα δεν την ορίζει αυτόματα.

Τεκμηρίωση — Όλοι οι οδηγοί και οι αναφορές του FastOG
Δωρεάν εργαλείο δοκιμής OG εικόνων— Προεπισκόπηση χωρίς λογαριασμό
Οδηγός γρήγορης εκκίνησης — περιλαμβάνει τη ροή αρχιτεκτονικής (υπογραφή κατά τον χρόνο απόδοσης)
Οδηγός υπογραφής HMAC
Επικύρωση HMAC
Εκμάθηση JavaScript

Δοκιμάστε το δωρεάν — δεν απαιτείται εγγραφή

Προεπισκόπηση και δοκιμή δυναμικών εικόνων OG σε δευτερόλεπτα.

Ανοίξτε τον Δωρεάν Ελεγκτή Εικόνων OG