Ένα POST βάζει την απόδοση σε ουρά. Κάντε polling στην εγγραφή ή ακούστε τη ζωντανή ροή κατάστασης, και μετά λάβετε το MP4 και το πλήρες επεξεργάσιμο scene graph του. Περιλαμβάνεται από το Plus και πάνω, με χρέωση 2x των λεπτών του πλάνου. Χωρίς ελάχιστο.
POST /v1/explainer
{
"input": "Explain how recurring billing works",
"length": "1:00", // optional, in 30-second steps up to "6:00"
"aspect": "16:9", // 16:9, 9:16, 1:1
"voice": "sketchie:sulafat", // Nora, the default narrator
"language": "en"
} Η δημιουργία είναι ασύγχρονη. Το API απαντά αμέσως με 202 Accepted και μια εγγραφή σε ουρά.
HTTP/1.1 202 Accepted
{
"id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
"status": "queued",
"prompt": "Explain how recurring billing works",
"lengthSeconds": 60,
"voice": "sketchie:sulafat",
"language": "en",
"aspect": "16:9",
"videoUrl": null,
"sceneGraph": null
} Ανακτήστε το GET /v1/explainer/:id μέχρι η εγγραφή να είναι ready, ή εγγραφείτε στο GET /v1/explainer/events για ζωντανές ενημερώσεις κατάστασης. Η έτοιμη εγγραφή φέρει το URL του MP4 και το scene graph.
GET /v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b
{
"id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
"status": "ready",
"videoUrl": "https://media.sketchie.ai/....mp4",
"sceneGraph": { "scenes": [ ... ] }
} Το API δεν σας δίνει απλώς ένα αρχείο. Σας δίνει ένα έγγραφο. Στείλτε μια επεξεργασία σε απλή γλώσσα μέσω του διαθέσιμου endpoint επεξεργασίας:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Δευτερόλεπτα αργότερα έχετε ένα νέο βίντεο με μία σκηνή αλλαγμένη και όλα τα άλλα ανέγγιχτα. Η νέα έκδοση παραμένει στο ιστορικό του ίδιου επεξηγηματικού, ώστε να μπορείτε να την επιθεωρήσετε ή να την επαναφέρετε μέσω του API.
Το Sketchie παρέχει έναν διακομιστή MCP, ώστε κάθε πράκτορας με δυνατότητα MCP να μπορεί να δημιουργεί και να επεξεργάζεται επεξηγηματικά βίντεο ως εγγενή εργαλεία: δημιουργία από έγγραφο, επιθεώρηση του scene graph, αίτημα επεξεργασίας, εκ νέου απόδοση. Αν φτιάχνετε πράκτορες που πρέπει να απαντούν με βίντεο αντί για έναν τοίχο κειμένου, αυτή είναι η συντομότερη διαδρομή που υπάρχει.
Επιλέξτε Nora, Miles, Dean, Clara, Piper ή Wren από το GET /v1/voices. Η Nora είναι ο ζεστός προεπιλεγμένος αφηγητής, και κάθε φωνή του καταλόγου μπορεί να μιλήσει κάθε υποστηριζόμενη γλώσσα. Οι προεπισκοπήσεις φωνής περιλαμβάνονται στην απόκριση του καταλόγου.