POST 한 번으로 렌더링을 대기열에 넣습니다. 레코드를 폴링하거나 라이브 상태 스트림을 듣고, 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
} 레코드가 ready가 될 때까지 GET /v1/explainer/:id를 가져오거나, 라이브 상태 업데이트를 위해 GET /v1/explainer/events를 구독하세요. 준비된 레코드는 MP4 URL과 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는 파일만 건네주지 않습니다. 문서를 건네줍니다. 출시된 편집 엔드포인트를 통해 평이한 언어로 된 편집을 보내세요:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } 몇 초 뒤면 한 장면만 바뀌고 나머지는 그대로인 새 영상이 생깁니다. 새 버전은 같은 설명 영상의 히스토리에 남으므로, API를 통해 검사하거나 되돌릴 수 있습니다.
Sketchie는 MCP 서버를 함께 제공하므로, MCP를 지원하는 모든 에이전트가 설명 영상을 네이티브 도구로 생성하고 편집할 수 있습니다. 문서에서 생성하고, scene graph를 검사하고, 편집을 요청하고, 다시 렌더링합니다. 텍스트 벽 대신 영상으로 답해야 하는 에이전트를 만들고 있다면, 이것이 존재하는 가장 짧은 길입니다.
GET /v1/voices에서 Nora, Miles, Dean, Clara, Piper 또는 Wren을 선택하세요. Nora는 따뜻한 기본 내레이터이며, 카탈로그의 모든 음성은 지원되는 모든 언어를 말할 수 있습니다. 음성 미리 듣기는 카탈로그 응답에 포함됩니다.