POST batek errenderizazioa ilaran jartzen du. Galdetu erregistroa edo entzun zuzeneko egoera-jarioa, eta gero jaso MP4a eta bere scene graph guztiz editagarria. Plus-etik gora barne, 2x plan-minututan neurtua. Gutxienekorik gabe.
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"
} Sorkuntza asinkronoa da. APIak berehala erantzuten du 202 Accepted-ekin eta ilaran dagoen erregistro batekin.
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
} Eskuratu GET /v1/explainer/:id erregistroa ready izan arte, edo harpidetu GET /v1/explainer/events-era zuzeneko egoera-eguneraketetarako. Prest dagoen erregistroak MP4 URLa eta scene graph-a daramatza.
GET /v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b
{
"id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
"status": "ready",
"videoUrl": "https://media.sketchie.ai/....mp4",
"sceneGraph": { "scenes": [ ... ] }
} APIak ez dizu fitxategi bat besterik ematen. Dokumentu bat ematen dizu. Bidali edizio bat lengoaia arruntean bidalitako edizio endpoint-aren bidez:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Segundo batzuk geroago bideo berri bat duzu eszena bat aldatuta eta gainerako guztia ukitu gabe. Bertsio berria azalpen beraren historian geratzen da, beraz API bidez azter dezakezu edo lehengoratu.
Sketchie-k MCP zerbitzari bat bidaltzen du, beraz MCP gaitasuna duen edozein agentek azalpen-bideoak sor eta edita ditzake tresna natibo gisa: sortu dokumentu batetik, aztertu scene graph-a, eskatu edizio bat, errenderizatu berriro. Testu-horma baten ordez bideoarekin erantzun beharko luketen agenteak eraikitzen ari bazara, hau da existitzen den biderik laburrena.
Aukeratu Nora, Miles, Dean, Clara, Piper edo Wren GET /v1/voices-etik. Nora kontalari lehenetsi epela da, eta katalogoko ahots bakoitzak onartutako hizkuntza bakoitza hitz egin dezake. Ahotsen aurrebistak katalogoaren erantzunean sartzen dira.