POST moja huweka uwasilishaji kwenye foleni. Poll rekodi au sikiliza mkondo wa hali ya moja kwa moja, kisha upokee MP4 na scene graph yake inayohaririwa kikamilifu. Imejumuishwa kutoka Plus na juu, hupimwa kwa 2x dakika za mpango. Hakuna kiwango cha chini.
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"
} Uundaji si sawia. API hujibu mara moja kwa 202 Accepted na rekodi iliyopo kwenye foleni.
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
} Leta GET /v1/explainer/:id hadi rekodi iwe ready, au jiandikishe kwa GET /v1/explainer/events kwa masasisho ya hali ya moja kwa moja. Rekodi iliyo tayari hubeba URL ya MP4 na 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 haikupatii tu faili. Inakupatia hati. Tuma uhariri kwa lugha rahisi kupitia endpoint ya kuhariri iliyotolewa:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Sekunde chache baadaye una video mpya yenye tukio moja lililobadilishwa na kila kitu kingine hakijaguswa. Toleo jipya hukaa katika historia ya maelezo yaleyale, hivyo unaweza kuikagua au kuirejesha kupitia API.
Sketchie hutoa seva ya MCP, hivyo wakala yeyote mwenye uwezo wa MCP anaweza kutengeneza na kuhariri video za maelezo kama zana asili: tengeneza kutoka hati, kagua scene graph, omba uhariri, wasilisha upya. Ikiwa unajenga mawakala wanaopaswa kujibu kwa video badala ya ukuta wa maandishi, hii ndiyo njia fupi zaidi iliyopo.
Chagua Nora, Miles, Dean, Clara, Piper au Wren kutoka GET /v1/voices. Nora ni msimuliaji chaguo-msingi mwenye joto, na kila sauti ya katalogi inaweza kuzungumza kila lugha inayotumika. Hakikisho za sauti zimejumuishwa katika jibu la katalogi.