POST មួយដាក់ render ចូលជួរ។ Poll កំណត់ត្រា ឬស្តាប់ស្ទ្រីមស្ថានភាពផ្ទាល់ បន្ទាប់មកទទួល 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 មិនគ្រាន់តែប្រគល់ឯកសារឱ្យអ្នកទេ។ វាប្រគល់ឯកសារមួយឱ្យអ្នក។ ផ្ញើការកែសម្រួលជាភាសាធម្មតាតាមរយៈ endpoint កែសម្រួលដែលបានចេញផ្សាយ៖
POST /v1/explainer/{id}/edit
{ "instruction": "Make the second scene shorter and warmer" } ប៉ុន្មានវិនាទីក្រោយមក អ្នកមានវីដេអូថ្មីមួយដែលឆាកមួយបានផ្លាស់ប្តូរ ហើយអ្វីៗផ្សេងទៀតមិនប៉ះពាល់។ កំណែថ្មីនៅតែស្ថិតក្នុងប្រវត្តិនៃការពន្យល់ដដែល ដូច្នេះអ្នកអាចពិនិត្យ ឬត្រឡប់វាតាមរយៈ API។
Sketchie ផ្តល់ម៉ាស៊ីនមេ MCP ដូច្នេះភ្នាក់ងារណាដែលមានសមត្ថភាព MCP អាចបង្កើត និងកែសម្រួលវីដេអូពន្យល់ជាឧបករណ៍ native: បង្កើតពីឯកសារ ពិនិត្យ scene graph ស្នើសុំការកែសម្រួល render ម្តងទៀត។ ប្រសិនបើអ្នកកំពុងសាងសង់ភ្នាក់ងារដែលគួរឆ្លើយដោយវីដេអូជំនួសឱ្យជញ្ជាំងអត្ថបទ នេះជាផ្លូវខ្លីបំផុតដែលមាន។
ជ្រើសរើស Nora, Miles, Dean, Clara, Piper ឬ Wren ពី GET /v1/voices។ Nora ជាអ្នកនិទានលំនាំដើមកក់ក្តៅ ហើយសំឡេងកាតាឡុកនីមួយៗអាចនិយាយភាសាដែលបានគាំទ្រនីមួយៗ។ ការមើលសំឡេងជាមុនត្រូវបានរួមបញ្ចូលក្នុងការឆ្លើយតបកាតាឡុក។