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 เพื่อรับการอัปเดตสถานะสด เรกคอร์ดที่พร้อมจะมี URL ของ MP4 และ 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 ขอการแก้ไข เรนเดอร์ใหม่ ถ้าคุณกำลังสร้างเอเจนต์ที่ควรตอบด้วยวิดีโอแทนกำแพงข้อความ นี่คือเส้นทางที่สั้นที่สุดที่มีอยู่
เลือก Nora, Miles, Dean, Clara, Piper หรือ Wren จาก GET /v1/voices Nora คือผู้บรรยายเริ่มต้นที่อบอุ่น และทุกเสียงในแคตตาล็อกพูดได้ทุกภาษาที่รองรับ ตัวอย่างเสียงรวมอยู่ในการตอบกลับแคตตาล็อก