Επισκόπηση και γρήγορη εκκίνηση

Το Sketchie μετατρέπει ένα prompt ή ένα έγγραφο σε επεξηγηματικό βίντεο πίνακα και σας επιστρέφει τόσο το αποδοσμένο βίντεο όσο και το επεξεργάσιμο scene graph του. Αυτή είναι η αναφορά για το HTTP API, το CLI, το TypeScript SDK και τον διακομιστή MCP.

Η πρόσβαση στο API περιλαμβάνεται σε κάθε επί πληρωμή πλάνο. Δημιουργήστε ένα κλειδί API από τις Ρυθμίσεις στην εφαρμογή μόλις αποκτήσετε ένα πλάνο. Οι δημιουργίες μέσω API αντλούν από τα λεπτά του πλάνου σας με τον ίδιο συντελεστή όπως η εφαρμογή. Δεν υπάρχει ξεχωριστή τιμή API.

Πιστοποίηση

Κάθε αίτημα πιστοποιείται με το κλειδί API σας ως διακριτικό Bearer. Δημιουργήστε ένα κλειδί στην εφαρμογή στις Ρυθμίσεις και στη συνέχεια στείλτε το στην κεφαλίδα Authorization:

Κεφαλίδα αιτήματος 
Authorization: Bearer sk_...

Το κλειδί εμφανίζεται μία φορά, κατά τη δημιουργία. Κρατήστε το μυστικό. Το βασικό URL για κάθε endpoint είναι https://sketchie.ai/api.

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

1. Δημιουργήστε ένα επεξηγηματικό

Στείλτε το θέμα σας ως input και ένα προαιρετικό στοχευόμενο μήκος ως length (μια φιλική συμβολοσειρά "M:SS" όπως "0:30" ή "1:00", σε βήματα των 30 δευτερολέπτων). Παραλείψτε το length για αυτόματο μήκος.

Terminal 
curl -X POST https://sketchie.ai/api/v1/explainer \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Explain how DNS resolves a domain name",
    "length": "0:30"
  }'

Η κλήση επιστρέφει 202 Accepted αμέσως με μια εγγραφή στην ουρά. Η απόδοση τρέχει στο παρασκήνιο και διαρκεί μερικά λεπτά.

202 Accepted 
{
  "id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
  "status": "queued",
  "prompt": "Explain how DNS resolves a domain name",
  "lengthSeconds": 30,
  "voice": "sketchie:sulafat",
  "language": "en",
  "aspect": "16:9",
  "videoUrl": null,
  "sceneGraph": null
}

2. Κάντε polling για το αποτέλεσμα

Ανακτήστε το επεξηγηματικό με βάση το id έως ότου το status του φτάσει σε τελική κατάσταση. Ο κύκλος ζωής είναι queued, μετά generating, μετά rendering, μετά ready (έτοιμο) ή failed.

Terminal 
curl https://sketchie.ai/api/v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b \
  -H "Authorization: Bearer sk_..."

Όταν είναι ready, η εγγραφή φέρει το URL του βίντεο και το επεξεργάσιμο scene graph:

200 OK 
{
  "id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
  "status": "ready",
  "videoUrl": "https://sketchie.ai/media/....mp4",
  "sceneGraph": { "scenes": [ ... ] }
}

Φιλικά και κλασικά ονόματα πεδίων. Τα input και length είναι τα φιλικά πεδία αιτήματος. Τα παλαιότερα prompt (συμβολοσειρά) και lengthSeconds (αριθμός, θετικό πολλαπλάσιο του 30) εξακολουθούν να γίνονται δεκτά ως ψευδώνυμα, ώστε οι υπάρχουσες ενσωματώσεις να συνεχίζουν να λειτουργούν. Όταν αποστέλλονται και τα δύο, κερδίζει το φιλικό πεδίο.

Πού να πάτε στη συνέχεια

  • Αναφορά API . Κάθε endpoint, με τις μορφές αιτήματος και απόκρισης.
  • Φωνές . Ο προεπιλεγμένος αφηγητής, ο κατάλογος έξι φωνών και οι αναπαραγώγιμες προεπισκοπήσεις.
  • Γλώσσες . Οι 34 υποστηριζόμενες γλώσσες αφήγησης.
  • CLI και SDK . Η γραμμή εντολών sketchie και ο πελάτης TypeScript @sketchie/sdk.
  • Ρύθμιση MCP . Χρησιμοποιήστε το Sketchie ως εργαλεία στο Claude Desktop, το Claude Code και την εφαρμογή Claude.