1 回の 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" } 数秒後には、1 つのシーンが変更され、他はすべて変わらない新しい動画が手に入ります。新しいバージョンは同じ解説動画の履歴に残るため、API を通じて検査したり元に戻したりできます。
Sketchie は MCP サーバーを出荷しているため、MCP 対応のエージェントは解説動画をネイティブツールとして生成・編集できます。ドキュメントから生成し、scene graph を検査し、編集をリクエストし、再レンダリングします。テキストの壁ではなく動画で応答すべきエージェントを構築しているなら、これが存在する最短の道です。
GET /v1/voices から Nora、Miles、Dean、Clara、Piper、Wren を選びます。Nora は温かみのあるデフォルトのナレーターで、カタログのすべての音声はサポートされているすべての言語を話せます。音声プレビューはカタログレスポンスに含まれます。