作为一次 API 调用的讲解视频。包含 scene graph。

一次 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
}

获取 GET /v1/explainer/:id 直到记录为 ready,或订阅 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": [ ... ] }
}
它的不同之处

scene graph 是可写的。

API 不只是递给你一个文件。它递给你一份文档。通过已上线的编辑端点发送一条平实语言的编辑:

POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" }

几秒后你就得到一个新视频,其中一个场景被改动,其他一切保持不变。新版本保留在同一讲解视频的历史中,因此你可以通过 API 检查或还原它。

MCP 服务器

Sketchie 附带一个 MCP 服务器,因此任何支持 MCP 的智能体都可以把讲解视频作为原生工具来生成和编辑:从文档生成、检查 scene graph、请求编辑、重新渲染。如果你正在构建应当用视频而不是一堵文字墙来回答的智能体,这是现存最短的路径。

MCP 设置文档

六位精选旁白

GET /v1/voices 中选择 Nora、Miles、Dean、Clara、Piper 或 Wren。Nora 是温暖的默认旁白,目录中的每个语音都能说所有支持的语言。语音预览包含在目录响应中。

清楚说明的定价

为生产而非演示而构建

Sketchie

获取一个 API 密钥。
API 访问随 Plus 及以上提供。

获取 API 密钥