Το Developer API του ClipMixAI είναι πλέον διαθέσιμο

Σήμερα ανοίγουμε τις μηχανές που τροφοδοτούν το web app του ClipMixAI σε όποιον θέλει να χτίσει κάτι πάνω τους. Το νέο Developer API στο api.clipmixai.com/api/v1 εκθέτει τέσσερις υπηρεσίες — μεταγλώττιση βίντεο, βίντεο αναμνήσεων, faceswap & avatars, και μουσική AI — μέσω μιας ενιαίας REST επιφάνειας με Bearer token. Ίδια μοντέλα, ίδια ποιότητα, ίδια credits. Δεν απαιτείται συνδρομή. Δεν υπάρχει ελάχιστο.

Αν προτιμάς να παραλείψεις την ανάλυση: το /api έχει τη γενική παρουσίαση, το /api/docs έχει την τεκμηρίωση, και το /dashboard/api-keys είναι εκεί που δημιουργείς το κλειδί σου.

Γιατί το φτιάξαμε

Τον τελευταίο χρόνο παρακολουθούσαμε χρήστες που επαναλάμβαναν την ίδια ακριβώς διαδικασία: ανοίγουν το dashboard, ανεβάζουν 30 φωτογραφίες, πατάνε δημιουργία, περιμένουν το τραγούδι, σπρώχνουν χειροκίνητα το αποτέλεσμα σε ένα ξεχωριστό εργαλείο επεξεργασίας. Είχαμε ιδρυτές που μετέφραζαν περιεχόμενο δημιουργών σε 10 γλώσσες, εταιρείες που παρήγαγαν 100 brand spots την εβδομάδα, ανεξάρτητα game studios που έφτιαχναν προσωρινή μουσική για πρωτότυπα. Όλοι τους κατέληγαν στην ίδια ερώτηση: «υπάρχει API;»

Τώρα υπάρχει. Οι τέσσερις υπηρεσίες που τροφοδοτούσαν όλες αυτές τις ροές εργασίας είναι πλέον κλήσιμες από τον κώδικά σου — χωρίς το dashboard στη μέση, χωρίς να χρειαστεί να μάθεις τις ιδιαιτερότητες κάθε παρόχου, και με την ίδια τιμολόγηση ανά credit που ήδη γνωρίζεις από το web app. Αν μια ροή που κάποτε έπαιρνε μια ώρα μπορεί τώρα να τρέχει από ένα CRON job στο παρασκήνιο, αυτό είναι το κέρδος.

Γρήγορη εκκίνηση

Δημιούργησε ένα κλειδί από το dashboard, και μετά:

curl -X POST https://api.clipmixai.com/api/v1/music \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: my-fresh-key-1" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt":   "Uplifting synthwave with female vocals",
    "lyrics":   "[verse]\nRunning through neon lights...",
    "duration_seconds": 60
  }'

Παίρνεις αμέσως πίσω ένα job-id με status: "processing". Είτε κάνεις polling στο GET /v1/music/{id} μέχρι η κατάσταση να γίνει completed, είτε — καλύτερα — συνδέεις ένα webhook στο κλειδί σου κατά τη δημιουργία του, και εμείς θα κάνουμε POST το αποτελέσμα στο endpoint σου, υπογεγραμμένο με HMAC-SHA256 για να επαληθεύσεις ότι προήλθε από εμάς.

Τρία πράγματα που ζητούσαν οι developers και δεν είχαμε παρέχει

1. Sandbox κλειδιά

Κάθε κλειδί API έχει ένα mode: το sk_live_ χρεώνει credits και καλεί πραγματικούς παρόχους· το sk_test_ δεν χρεώνει ποτέ, δεν καλεί ποτέ πάροχο, και επιστρέφει ένα συνθετικό job completed με test: true στο body. Χρησιμοποίησε sandbox κλειδιά στο CI για να επαληθεύσεις την ενσωμάτωσή σου χωρίς να σπαταλάς credits, και άλλαξε σε live κλειδιά όταν θέλεις πραγματικό αποτέλεσμα.

Τα sandbox κλειδιά είναι δωρεάν για όλους — συμπεριλαμβανομένων των δωρεάν λογαριασμών. Η μόνη προϋπόθεση για χρήση live κλειδιού είναι μία προηγούμενη αγορά credits, που τοποθετεί το API πίσω από το ίδιο payment signal με το web app.

2. Idempotency-Key σε κάθε POST

Οι επαναλήψεις δικτύου είναι ο εφιάλτης κάθε API με χρέωση. Δανειστήκαμε τη λύση του Stripe: πέρασε Idempotency-Key: <string-σου> σε οποιαδήποτε κλήση δημιουργίας και ο server αποθηκεύει την απάντηση για 24 ώρες. Μια επανάληψη με το ίδιο κλειδί + ίδιο body επιστρέφει την αρχική απάντηση — ποτέ διπλή χρέωση. Μια επανάληψη με το ίδιο κλειδί αλλά διαφορετικό body επιστρέφει 422 idempotency_key_reuse για να βρεις το σφάλμα αντί να παραχθεί σιωπηλά λάθος job.

Και τα δύο επίσημα SDK το εκθέτουν ως ένα μόνο keyword argument:

# Python
c.music.create(prompt=..., lyrics=..., idempotency_key="order-42")

// JS
await c.music.create({ prompt, lyrics, idempotencyKey: "order-42" });

3. Webhooks με κουμπί δοκιμαστικής αποστολής

Ρύθμισε ένα callback URL στο κλειδί σου και θα κάνουμε POST τα events job.completed / job.failed καθώς ολοκληρώνονται τα jobs. Κάθε παράδοση φέρει υπογραφή HMAC στο X-ClipMix-Signature: sha256=<hex> — επαλήθευσέ την με ένα helper από οποιοδήποτε SDK. Οι αποτυχημένες παραδόσεις επαναλαμβάνονται με εκθετική καθυστέρηση (0δλ → 30δλ → 5λ → 1ω, συνολικά τέσσερις προσπάθειες).

Το dashboard έχει ένα κουμπί Δοκιμαστική αποστολή που στέλνει ένα συνθετικό event webhook.test για να επαληθεύσεις την υπογραφή/ανάλυση του endpoint σου χωρίς να περιμένεις πραγματικό job. Το ίδιο panel εμφανίζει αρχείο 100 παραδόσεων ανά κλειδί, ώστε όταν κάτι πάει στραβά να μην χρειαστεί να μαντέψεις πού απέτυχε.

Τρεις περιπτώσεις χρήσης που ήδη βλέπουμε

Μαζική μεταγλώττιση βίντεο για δημιουργούς

Ανεβάζεις ένα βίντεο, παίρνεις 10 μεταγλωττισμένες εκδοχές σε 10 γλώσσες, με προαιρετική κλωνοποίηση φωνής που διατηρεί τον τόνο του ομιλητή. Ένας YouTuber μεταφράζει το εβδομαδιαίο podcast του σε 9 γλώσσες αυτόματα — η κλήση API πυροδοτείται από το υπάρχον publish hook του, και το webhook ρίχνει το μεταγλωττισμένο αρχείο στο CMS του.

Εξατομικευμένα brand βίντεο ανά πελάτη

Η δυνατότητα μετατροπής φωτογραφιών σε βίντεο αναμνήσεων σημαίνει ότι ένα e-commerce κατάστημα μπορεί να πάρει τη φωτογραφία προϊόντος ενός πελάτη και να δημιουργήσει μια σύντομη κινηματογραφική διαφήμιση εξατομικευμένη για εκείνη την καταχώριση. Το endpoint family-videos εκθέτει τους τέσσερις τρόπους (Moment, Story, Album, Chronicle) που φτιάξαμε για το consumer UI· εταιρείες τα χρησιμοποιούν ως κινητήρα μέσα σε white-label εργαλεία.

Πρωτοτυποποίηση ήχου για παιχνίδια

Ανεξάρτητα studios καλούν το endpoint /v1/music από μέσα στο εσωτερικό τους pipeline assets. Ένας game designer γράφει μια διάθεση και ένα απόσπασμα placeholder στίχων, και ένα κομμάτι 60 δευτερολέπτων εμφανίζεται στον φάκελο ήχου του project δέκα λεπτά αργότερα. Επαναλαμβάνουν τη δοκιμαστική μουσική σε δευτερόλεπτα, αντί να περιμένουν τον sound designer για κάθε παραλλαγή.

Versioning και δεσμεύσεις μας

Το v1 είναι σταθερό. Δεν θα εισάγουμε breaking changes μέσα στο /api/v1/ — νέα πεδία και νέα endpoints προστίθενται μόνο ως προσθήκες, και η υπάρχουσα επιφάνεια παραμένει ως έχει. Ό,τι χρειαστεί να σπάσουμε (σπάνια) θα κυκλοφορήσει υπό /api/v2/ με ανακοινωμένη περίοδο μετάβασης. Το changelog είναι η αξιόπιστη πηγή αλήθειας.

Η επιχειρησιακή κατάσταση είναι ζωντανή στο /api/status — ένα στιγμιότυπο υγείας ανά υπηρεσία που προκύπτει από την πραγματική κίνηση των τελευταίων 5 λεπτών. Ενημερώνεται κάθε 60 δευτερόλεπτα και είναι η ίδια εικόνα που βλέπει η ομάδα oncall.

Τιμολόγηση

Ίδιο πορτοφόλι με το web app. $1 = 100 credits, με τα υπάρχοντα bonus όγκου στις αναπληρώσεις. Ένα τραγούδι 60 δευτερολέπτων κοστίζει 60 credits ($0.60). Ένα talking-head avatar 30 δευτερολέπτων κοστίζει 450 credits στο balanced tier. Η μεταγλώττιση ενός βίντεο 1 λεπτού σε premium tier κοστίζει ~190 credits. Τα sandbox κλειδιά είναι δωρεάν.

Έρχονται πλάνα API ανά βαθμίδα (Pro / Business / Enterprise) με εκπτώσεις μαζικής χρήσης και προτεραιότητα εργαζομένων. Αν σε ενδιαφέρουν σήμερα, άφησε το email σου στο /contact?topic=api-tiers και θα σε ενημερώσουμε μόλις κυκλοφορήσουν.

Δοκίμασέ το

• /api — παρουσίαση πέντε λεπτών
• /api/docs — τεκμηρίωση (auth, idempotency, webhooks, sandbox, σφάλματα, SDKs)
• /api/status — ζωντανή υγεία υπηρεσιών
• /api/changelog — τι κυκλοφόρησε, τι έρχεται
• /dashboard/api-keys — δημιούργησε το πρώτο σου κλειδί

Αναφορές σφαλμάτων και αιτήματα για νέα χαρακτηριστικά: GitHub Issues. Για οτιδήποτε άλλο: support@clipmixai.com.