ერთი 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": [ ... ] }
} API თქვენ არა მხოლოდ ფაილს გაწვდით. ის დოკუმენტს გაწვდით. გააგზავნეთ რედაქტირება მარტივ ენაზე მიწოდებული რედაქტირების endpoint-ის მეშვეობით:
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 არის თბილი ნაგულისხმევი მთხრობელი, და კატალოგის ყოველ ხმას შეუძლია ილაპარაკოს ყოველ მხარდაჭერილ ენაზე. ხმის წინასწარი მოსმენები ჩართულია კატალოგის პასუხში.