Yon POST mete render la nan fil. Poll dosye a oswa koute flux estati an dirèk, epi resevwa MP4 la ak scene graph li ki ka edite konplètman. Enkli soti nan Plus monte, mezire nan 2x minit plan. Pa gen minimòm.
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"
} Kreyasyon an asynkwòn. API a reponn imedyatman ak 202 Accepted ak yon dosye nan fil.
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
} Rekipere GET /v1/explainer/:id jiskaske dosye a ready, oswa abòne nan GET /v1/explainer/events pou mizajou estati an dirèk. Dosye ki pare a pote URL MP4 la ak scene graph la.
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 a pa jis lonje yon fichye ba ou. Li lonje yon dokiman ba ou. Voye yon edisyon nan langaj senp atravè endpoint edisyon ki livre a:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Kèk segond pita ou gen yon nouvo videyo ak yon sèn chanje ak tout rès la pa manyen. Nouvo vèsyon an rete nan istwa menm eksplikasyon an, kidonk ou ka enspekte oswa retounen li atravè API a.
Sketchie livre yon sèvè MCP, kidonk nenpòt ajan ki kapab MCP ka jenere ak edite videyo eksplikasyon kòm zouti natif: jenere depi yon dokiman, enspekte scene graph la, mande yon edisyon, render ankò. Si w ap bati ajan ki ta dwe reponn ak videyo olye yon miray tèks, sa a se chemen ki pi kout ki egziste.
Chwazi Nora, Miles, Dean, Clara, Piper oswa Wren nan GET /v1/voices. Nora se naratè default cho a, epi chak vwa katalòg ka pale chak lang ki sipòte. Apèsi vwa yo enkli nan repons katalòg la.