Τεκμηρίωση API

Εισαγωγή

Το Flixy API επιτρέπει στο λογισμικό σας να χρησιμοποιεί τις λειτουργίες του Flixy Studio: δημιουργία πλήρων ιστότοπων από μια περιγραφή, επεξεργασία και μετάφρασή τους, συγγραφή περιεχομένου ιστότοπου, ανάγνωση καταλόγων φαγητών, καταλόγων προϊόντων και PDF, και δημιουργία εικόνων και λογοτύπων. Πληρώνετε μόνο για τις επιτυχημένες κλήσεις, από ένα προπληρωμένο υπόλοιπο.

Οι μεγάλες διεργασίες (δημιουργία, επεξεργασία ή μετάφραση ιστότοπου) εκτελούνται ως εργασίες: το API απαντά αμέσως και εσείς παρακολουθείτε την εργασία ή λαμβάνετε ένα webhook. Το περιεχόμενο, η ανάγνωση εγγράφων και οι εικόνες απαντούν απευθείας, συνήθως σε λίγα δευτερόλεπτα.

Κονσόλα προγραμματιστών

Τα κλειδιά, το υπόλοιπο, οι φορτίσεις, τα webhooks και τα αρχεία κλήσεων διαχειρίζονται στην κονσόλα προγραμματιστών στο dev.flixy.studio.

• Ξεχωριστός λογαριασμός προγραμματιστή. Όπως σε άλλες πλατφόρμες AI, ο λογαριασμός προγραμματιστή σας είναι διαφορετικός από τον λογαριασμό σας στο Flixy Studio: έχει δική του εγγραφή, σύνδεση και συνεδρία. Η αποσύνδεση από τον έναν δεν σας αποσυνδέει ποτέ από τον άλλο. Μπορείτε να χρησιμοποιήσετε την ίδια διεύθυνση email και για τους δύο.
• Διασυνδεδεμένος οργανισμός. Αν χρησιμοποιείτε και το Flixy Studio, μπορείτε να διασυνδέσετε τον οργανισμό σας με τον λογαριασμό προγραμματιστή σας, ώστε το API να μπορεί να εργάζεται στους ιστότοπούς του. Δείτε Διασυνδεδεμένος οργανισμός.
• Ασφάλεια λογαριασμού. Η επαλήθευση σε δύο βήματα, οι ενεργές συνεδρίες και η εξαγωγή δεδομένων είναι διαθέσιμες στην κονσόλα, στην ενότητα Λογαριασμός.

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

Στείλτε το κλειδί σας στην κεφαλίδα Authorization κάθε αιτήματος. Τα κλειδιά ξεκινούν με fx_live_ ή fx_test_.

Authorization: Bearer fx_live_8sJ2…

curl https://flixy.studio/v1/account \
  -H "Authorization: Bearer $FLIXY_API_KEY"

Κάθε κλειδί έχει δικαιώματα (scopes). Μια κλήση χωρίς το κατάλληλο δικαίωμα επιστρέφει 403 missing_scope.

Κλειδιά δοκιμής και live

• Τα κλειδιά δοκιμής (fx_test_…) είναι δωρεάν. Επιστρέφουν ρεαλιστικά δείγματα απαντήσεων χωρίς χρήση AI, ώστε να μπορείτε να φτιάξετε και να δοκιμάσετε ολόκληρη την ενσωμάτωσή σας. Οι εργασίες ιστότοπου ολοκληρώνονται μετά από λίγα δευτερόλεπτα με έναν ιστότοπο-δείγμα.
• Τα κλειδιά live (fx_live_…) επιστρέφουν πραγματικά αποτελέσματα και χρεώνονται στο υπόλοιπό σας.

Κάθε απάντηση περιέχει την κεφαλίδα Flixy-Mode: test ή Flixy-Mode: live.

Αιτήματα και απαντήσεις

Στείλτε σώματα JSON με Content-Type: application/json (έως 16 MB). Οι απαντήσεις είναι σε JSON. Οι ημερομηνίες χρησιμοποιούν ISO 8601 σε UTC. Κάθε απάντηση έχει μια κεφαλίδα X-Request-Id: δώστε την στην υποστήριξή μας αν χρειάζεστε βοήθεια με μια κλήση.

Ορίστε το Accept-Language για να λαμβάνετε τα μηνύματα σφάλματος στη γλώσσα σας (fr, en, es, de, it, pt, nl, ca, el, sv, no, da, fi, is, et, lv, lt, ja· αγγλικά από προεπιλογή).

Σφάλματα

Τα σφάλματα χρησιμοποιούν τυπικούς κωδικούς κατάστασης HTTP και έχουν πάντα την ίδια μορφή:

{
  "error": {
    "type": "billing_error",
    "code": "insufficient_balance",
    "message": "Insufficient balance: top up your developer account…",
    "request_id": "req_5c1f0a9e2b7d4c11"
  }
}

Όρια ρυθμού

• 60 αιτήματα ανά λεπτό ανά κλειδί (κεφαλίδα X-RateLimit-Limit).
• 3 εργασίες ιστότοπου ταυτόχρονα ανά λογαριασμό. Οι κλήσεις περιεχομένου, εγγράφων και εικόνων δεν υπόκεινται σε αυτό το όριο.
• Όταν συμπληρωθεί ένα όριο, το API απαντά 429 με μια κεφαλίδα Retry-After σε δευτερόλεπτα.

Χρειάζεστε περισσότερα; Γράψτε στο contact@flixy.studio περιγράφοντας την περίπτωση χρήσης σας.

Idempotency

Τα σφάλματα δικτύου συμβαίνουν. Προσθέστε μια κεφαλίδα Idempotency-Key (8 έως 100 χαρακτήρες, για παράδειγμα το δικό σας αναγνωριστικό παραγγελίας) σε οποιοδήποτε POST: αν στείλετε ξανά το ίδιο αίτημα εντός 24 ωρών, το API επιστρέφει την πρώτη απάντηση — με την κεφαλίδα Idempotent-Replayed: true — και δεν εκτελεί ούτε χρεώνει ποτέ την εργασία δύο φορές.

Εργασίες

Η δημιουργία, η επεξεργασία και η μετάφραση ενός ιστότοπου διαρκούν από περίπου 30 δευτερόλεπτα έως 3 λεπτά. Αυτά τα endpoints απαντούν 202 Accepted με μια εργασία. Ελέγχετέ την κάθε 5 δευτερόλεπτα ή περιμένετε το συμβάν job.succeeded / job.failed μέσω webhook.

{
  "id": "job_69023cfbb08a8130d8f6",
  "object": "job",
  "type": "site",
  "status": "succeeded",
  "mode": "live",
  "site_id": "691589621",
  "price": 0.72,
  "currency": "EUR",
  "created_at": "2026-11-11T09:45:01Z",
  "finished_at": "2026-11-11T09:46:35Z",
  "result": { "id": "691589621", "object": "site", "status": "ready", "pages": ["index.html", "menu.html"] }
}

Το status είναι queued, running, succeeded ή failed. Μια αποτυχημένη εργασία δεν χρεώνεται ποτέ και το error της εξηγεί τον λόγο.

Δημιουργία ιστότοπου

Δημιουργεί έναν πλήρη ιστότοπο από μια περιγραφή. Δικαίωμα: sites:write.

curl https://flixy.studio/v1/sites \
  -H "Authorization: Bearer $FLIXY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042" \
  -d '{
    "prompt": "Website for an artisan bakery in Lyon: sourdough breads, pastries, online pre-orders",
    "language": "fr",
    "structure": "multipage",
    "features": ["contact_form", "map", "shop"],
    "business": { "name": "Boulangerie du Parc", "city": "Lyon", "phone": "+33 4 00 00 00 00" }
  }'

const res = await fetch('https://flixy.studio/v1/sites', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.FLIXY_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'order-1042',
  },
  body: JSON.stringify({
    prompt: 'Website for an artisan bakery in Lyon: sourdough breads, pastries, online pre-orders',
    language: 'fr',
    business: { name: 'Boulangerie du Parc', city: 'Lyon' },
  }),
});
const job = await res.json(); // 202 → { id: 'job_…', status: 'queued', site_id: '…' }

import os, requests

job = requests.post(
    'https://flixy.studio/v1/sites',
    headers={'Authorization': f"Bearer {os.environ['FLIXY_API_KEY']}", 'Idempotency-Key': 'order-1042'},
    json={'prompt': 'Website for an artisan bakery in Lyon: sourdough breads, pastries, online pre-orders',
          'language': 'fr', 'business': {'name': 'Boulangerie du Parc', 'city': 'Lyon'}},
    timeout=30,
).json()

function flixy(string $method, string $path, ?array $body = null): array {
    $ch = curl_init('https://flixy.studio/v1' . $path);
    curl_setopt_array($ch, [
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLIXY_API_KEY'), 'Content-Type: application/json'],
        CURLOPT_POSTFIELDS => $body ? json_encode($body) : null,
    ]);
    return json_decode(curl_exec($ch), true);
}

$job = flixy('POST', '/sites', ['prompt' => 'Website for an artisan bakery in Lyon', 'language' => 'fr']);

Ανάκτηση ιστότοπου

Επιστρέφει τον ιστότοπο, την κατάστασή του και τις σελίδες του. Προσθέστε include=html για να λάβετε το πλήρες HTML κάθε σελίδας (οι εικόνες φιλοξενούνται από το Flixy). Δικαίωμα: sites:read.

{
  "id": "691589621",
  "object": "site",
  "name": "Boulangerie du Parc",
  "status": "ready",
  "language": "fr",
  "pages": ["index.html", "menu.html", "contact.html"],
  "owner": "developer",
  "html": { "index.html": "<!doctype html>…" }
}

Προσθέστε owner=developer ή owner=organization στη λίστα για φιλτράρισμα κατά κάτοχο. Οι ιστότοποι ενός διασυνδεδεμένου οργανισμού επιστρέφουν επίσης dashboard_url και editor_url, για να τους ανοίξετε στο Flixy Studio.

Επεξεργασία ιστότοπου

Εφαρμόζει μια αλλαγή που περιγράφεται σε απλή γλώσσα, όπως στον επεξεργαστή του Flixy. Κάθε αλλαγή δημιουργεί νέα έκδοση. Δικαίωμα: sites:write.

curl https://flixy.studio/v1/sites/691589621/edits \
  -H "Authorization: Bearer $FLIXY_API_KEY" -H "Content-Type: application/json" \
  -d '{"instruction": "Add an opening hours section: Tuesday to Saturday, 7am to 7pm"}'

Μετάφραση ιστότοπου

Μεταφράζει κάθε σελίδα του ιστότοπου — πλοήγηση, κουμπιά, φόρμες, περιγραφές εικόνων, τίτλο και περιγραφή για μηχανές αναζήτησης — διατηρώντας τη σχεδίαση, τις εικόνες, τους συνδέσμους, τις τιμές και τα στοιχεία επικοινωνίας. Δικαίωμα: sites:write.

Συγγραφή περιεχομένου web

Γράφει περιεχόμενο που προορίζεται για δημοσίευση σε ιστότοπο ή για αποστολή από μια επιχείρηση στους πελάτες της. Απαντά απευθείας. Δικαίωμα: content:write.

curl https://flixy.studio/v1/content \
  -H "Authorization: Bearer $FLIXY_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "type": "product_description",
    "language": "it",
    "topic": "Pizza Margherita cooked in a wood-fired oven",
    "facts": "San Marzano tomatoes, fior di latte mozzarella, fresh basil, 48-hour dough",
    "length": "short"
  }'

{
  "id": "job_af25ef1e01c5dbb8e400",
  "object": "content",
  "type": "product_description",
  "language": "it",
  "title": "Pizza Margherita al forno a legna",
  "html": "<p>…</p>",
  "text": "…",
  "meta": { "title": "…", "description": "…" },
  "items": [],
  "ai_generated": true,
  "usage": { "price": 0.01, "currency": "EUR", "mode": "live" }
}

Το πεδίο html περιέχει μόνο ασφαλείς ετικέτες κειμένου (επικεφαλίδες, παραγράφους, λίστες, συνδέσμους), ποτέ scripts ή styles.

Ανάγνωση εγγράφου

Διαβάζει έναν κατάλογο φαγητών, έναν κατάλογο προϊόντων, έναν τιμοκατάλογο, μια επαγγελματική κάρτα, ένα flyer ή ένα φυλλάδιο και επιστρέφει δομημένο περιεχόμενο έτοιμο για ιστότοπο. Επιστρέφεται μόνο ό,τι είναι πραγματικά γραμμένο. Δικαίωμα: extract:write.

{
  "object": "extract",
  "kind": "menu",
  "business": { "name": "Trattoria Sole", "phone": "…", "hours": "…" },
  "language": "es",
  "sections": [
    { "title": "Pizzas", "items": [ { "name": "Margherita", "description": "…", "price": "11.50" } ] }
  ],
  "colors": ["#b5121b"],
  "usage": { "price": 0.03, "currency": "EUR", "mode": "live" }
}

Δημιουργία εικόνας

Δημιουργεί μια φωτογραφία, μια εικονογράφηση ή ένα λογότυπο για ιστότοπο. Η εικόνα φιλοξενείται από το Flixy και φέρει μέσα στο αρχείο την τυπική σήμανση IPTC για μέσα που δημιουργούνται από AI. Δικαίωμα: images:write.

Υπόλοιπο και λογαριασμός

Επιστρέφει το υπόλοιπό σας, το ποσό που έχει δεσμευτεί για εργασίες σε εξέλιξη, το διαθέσιμο ποσό, τις μηνιαίες δαπάνες σας και το κλειδί που χρησιμοποιείται. Δικαίωμα: account:read.

{
  "object": "account",
  "balance": 48.92,
  "available": 45.92,
  "reserved": 3.00,
  "currency": "EUR",
  "spent_this_month": 12.40,
  "key": { "name": "Production server", "mode": "live", "scopes": ["sites:write", "sites:read"] },
  "limits": { "requests_per_minute": 60, "concurrent_site_jobs": 3 }
}

Χρήση και τιμές

Το /v1/usage επιστρέφει τις κλήσεις και τα ποσά σας ανά λειτουργία για μια περίοδο. Το /v1/pricing επιστρέφει τις τρέχουσες συνήθεις και ελάχιστες τιμές στο νόμισμά σας.

Κάθε επιτυχημένη κλήση κοστίζει το πραγματικό κόστος της εργασίας AI που απαιτήθηκε, πολλαπλασιασμένο με το περιθώριο του Flixy, με ελάχιστη χρέωση ανά λειτουργία. Πριν ξεκινήσει μια εργασία ιστότοπου, δεσμεύεται ένα εκτιμώμενο ποσό στο υπόλοιπό σας· η ακριβής τιμή χρεώνεται στο τέλος και το υπόλοιπο αποδεσμεύεται. Οι αποτυχημένες και απορριφθείσες κλήσεις δεν χρεώνονται ποτέ.

Webhooks

Προσθέστε μια διεύθυνση https του διακομιστή σας στον χώρο προγραμματιστή και επιλέξτε τα συμβάντα: job.succeeded, job.failed, balance.low, topup.succeeded. Το Flixy στέλνει ένα POST με ένα συμβάν JSON· απαντήστε με κατάσταση 2xx εντός 10 δευτερολέπτων. Οι αποτυχημένες παραδόσεις επαναλαμβάνονται· μια διεύθυνση που αποτυγχάνει συνεχώς τίθεται σε παύση.

POST /your/webhook
Flixy-Signature: t=1762854395,v1=8f0c3b…

{
  "id": "evt_2b0a…",
  "object": "event",
  "type": "job.succeeded",
  "created_at": "2026-11-11T09:46:35Z",
  "data": { "id": "job_6902…", "type": "site", "status": "succeeded", "site_id": "691589621", "price": 0.72 }
}

Επαλήθευση της υπογραφής

Η κεφαλίδα Flixy-Signature περιέχει μια χρονοσφραγίδα t και το v1, το HMAC-SHA256 του t + "." + raw body με το μυστικό webhook σας. Απορρίψτε μηνύματα παλαιότερα των 5 λεπτών.

import crypto from 'node:crypto';

export function verifyFlixy(rawBody, header, secret) {
  const p = Object.fromEntries(header.split(',').map((x) => x.split('=')));
  const sig = crypto.createHmac('sha256', secret).update(`${p.t}.${rawBody}`).digest('hex');
  return Math.abs(Date.now() / 1000 - Number(p.t)) < 300
    && crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(p.v1));
}

import hmac, hashlib, time

def verify_flixy(raw_body: bytes, header: str, secret: str) -> bool:
    p = dict(x.split('=', 1) for x in header.split(','))
    sig = hmac.new(secret.encode(), f"{p['t']}.".encode() + raw_body, hashlib.sha256).hexdigest()
    return abs(time.time() - int(p['t'])) < 300 and hmac.compare_digest(sig, p['v1'])

function flixy_verify(string $raw, string $header, string $secret): bool {
    parse_str(str_replace(',', '&', $header), $p);
    $sig = hash_hmac('sha256', $p['t'] . '.' . $raw, $secret);
    return abs(time() - (int)$p['t']) < 300 && hash_equals($sig, (string)$p['v1']);
}

Χρέωση

• Φορτίστε το υπόλοιπό σας από 10 € στον χώρο προγραμματιστή, με κάρτα. Ο ΦΠΑ προστίθεται ανάλογα με τη χώρα σας· αποστέλλεται τιμολόγιο για κάθε φόρτιση.
• Ενεργοποιήστε την αυτόματη φόρτιση για να φορτίζεται ένα ποσό της επιλογής σας όταν το υπόλοιπό σας πέφτει κάτω από ένα όριο.
• Ορίστε μηνιαίο όριο δαπανών για τον λογαριασμό και ημερήσιο όριο ανά κλειδί.
• Λαμβάνετε ένα email και ένα webhook balance.low όταν το υπόλοιπό σας είναι χαμηλό.

Πλήρεις όροι: Όροι & Πολιτική χρήσης του Flixy API.

Λίστα ελέγχου ασφαλείας

• Κρατήστε τα κλειδιά στον διακομιστή σας, σε μεταβλητές περιβάλλοντος ή σε διαχειριστή μυστικών — ποτέ σε ιστοσελίδα, σε εφαρμογή για κινητά ή σε αποθετήριο κώδικα.
• Δημιουργήστε ένα κλειδί ανά εφαρμογή και δώστε του μόνο τα δικαιώματα που χρειάζεται.
• Περιορίστε τα κλειδιά live στις διευθύνσεις IP των διακομιστών σας και ορίστε ημερήσιο όριο.
• Επαληθεύετε την υπογραφή και τη χρονοσφραγίδα κάθε webhook.
• Χρησιμοποιήστε κλειδί idempotency για κάθε POST.
• Διαγράψτε αμέσως ένα κλειδί αν μπορεί να έχει εκτεθεί και, στη συνέχεια, δημιουργήστε νέο.
• Ελέγξτε το περιεχόμενο που δημιουργείται από AI πριν το δημοσιεύσετε, και ενημερώνετε τους χρήστες σας όταν ένα περιεχόμενο έχει δημιουργηθεί από AI, όπου το απαιτεί ο νόμος.

Πολιτική χρήσης

Το Flixy API έχει σχεδιαστεί για ιστότοπους και το περιεχόμενό τους. Απορρίπτει, χωρίς χρέωση, γενικές ερωτήσεις άσχετες με ιστότοπους, κώδικα για άλλο λογισμικό, απόπειρες αλλαγής των οδηγιών του Flixy και περιεχόμενο που παραβιάζει την πολιτική μας (παράνομο, μισαλλόδοξο, σεξουαλικό περιεχόμενο με ανηλίκους, σελίδες phishing ή πλαστοπροσωπίας, spam, ψεύτικες κριτικές). Διαβάστε ολόκληρους τους Όρους & Πολιτική χρήσης του API.

Διασυνδεδεμένος οργανισμός

Διασυνδέστε τον οργανισμό σας στο Flixy Studio από την κονσόλα (Οργανισμός). Ο κάτοχος του λογαριασμού Flixy Studio εγκρίνει τη διασύνδεση ενώ είναι συνδεδεμένος στο Flixy Studio, και οποιαδήποτε από τις δύο πλευρές μπορεί να την καταργήσει ανά πάσα στιγμή. Μετά τη διασύνδεση:

• το API μπορεί να παραθέτει, να διαβάζει, να επεξεργάζεται και να μεταφράζει τους ιστότοπους του οργανισμού (sites:read, sites:write)·
• μπορείτε να δημιουργήσετε έναν ιστότοπο απευθείας στον οργανισμό με "destination": "organization" ή να μεταφέρετε έναν ιστότοπο που δημιουργήθηκε από το API με POST /v1/sites/{id}/transfer (δωρεάν), για να τον δημοσιεύσετε σε ένα domain από το Flixy Studio·
• όλη η εργασία του API χρεώνεται στο υπόλοιπο API σας: οι πιστώσεις του οργανισμού δεν χρησιμοποιούνται ποτέ.

curl "https://flixy.studio/v1/sites?owner=organization" \
  -H "Authorization: Bearer $FLIXY_API_KEY"

curl -X POST https://flixy.studio/v1/sites/691589621/transfer \
  -H "Authorization: Bearer $FLIXY_API_KEY"

{
  "id": "691589621",
  "object": "site",
  "owner": "organization",
  "dashboard_url": "https://flixy.studio/app/?v=sites",
  "editor_url": "https://flixy.studio/691589621"
}

Χωρίς διασυνδεδεμένο οργανισμό, αυτές οι κλήσεις επιστρέφουν 409 organization_not_linked.

Ιστορικό αλλαγών

• v1 — Νοέμβριος 2026. Πρώτη έκδοση: ιστότοποι, αλλαγές, μεταφράσεις, περιεχόμενο, ανάγνωση εγγράφων, εικόνες, εργασίες, webhooks, προπληρωμένο υπόλοιπο.

Οι αλλαγές που μπορεί να χαλάσουν την ενσωμάτωσή σας ανακοινώνονται με email τουλάχιστον 90 ημέρες νωρίτερα.