Một POST đưa render vào hàng đợi. Thăm dò bản ghi hoặc lắng nghe luồng trạng thái trực tiếp, rồi nhận MP4 và scene graph đầy đủ có thể chỉnh sửa của nó. Bao gồm từ Plus trở lên, tính theo 2x phút gói. Không có mức tối thiểu.
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"
} Việc tạo là bất đồng bộ. API phản hồi ngay lập tức bằng 202 Accepted và một bản ghi trong hàng đợi.
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
} Lấy GET /v1/explainer/:id cho đến khi bản ghi ở trạng thái ready, hoặc đăng ký GET /v1/explainer/events để nhận cập nhật trạng thái trực tiếp. Bản ghi sẵn sàng mang URL MP4 và 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 không chỉ đưa cho bạn một tệp. Nó đưa cho bạn một tài liệu. Gửi một chỉnh sửa bằng ngôn ngữ đơn giản qua endpoint chỉnh sửa đã phát hành:
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } Vài giây sau bạn có một video mới với một cảnh thay đổi và mọi thứ khác giữ nguyên. Phiên bản mới nằm trong lịch sử của cùng video giải thích đó, nên bạn có thể kiểm tra hoặc hoàn nguyên nó qua API.
Sketchie phát hành một máy chủ MCP, nên bất kỳ tác nhân hỗ trợ MCP nào cũng có thể tạo và chỉnh sửa video giải thích như các công cụ gốc: tạo từ một tài liệu, kiểm tra scene graph, yêu cầu một chỉnh sửa, render lại. Nếu bạn đang xây dựng các tác nhân nên trả lời bằng video thay vì một bức tường chữ, đây là con đường ngắn nhất tồn tại.
Chọn Nora, Miles, Dean, Clara, Piper hoặc Wren từ GET /v1/voices. Nora là người dẫn mặc định ấm áp, và mọi giọng trong danh mục đều có thể nói mọi ngôn ngữ được hỗ trợ. Bản xem trước giọng có trong phản hồi danh mục.