ទិដ្ឋភាពទូទៅ និងការចាប់ផ្តើមរហ័ស

Sketchie បំប្លែង prompt ឬឯកសារមួយទៅជាវីដេអូពន្យល់ក្តារខៀន ហើយប្រគល់ជូនអ្នកទាំងវីដេអូដែលបាន render និង scene graph ដែលអាចកែសម្រួលបានរបស់វា។ នេះជាឯកសារយោងសម្រាប់ HTTP API, CLI, TypeScript SDK និងម៉ាស៊ីនមេ MCP។

ការចូលប្រើ API ត្រូវបានរួមបញ្ចូលក្នុងគ្រប់គម្រោងបង់ប្រាក់។ បង្កើតកូនសោ API ពី ការកំណត់ ក្នុងកម្មវិធីនៅពេលអ្នកមានគម្រោង។ ការបង្កើតតាម API ទាញយកនាទីនៃគម្រោងរបស់អ្នកតាមអត្រាដូចគ្នានឹងកម្មវិធី។ គ្មានតម្លៃ API ដាច់ដោយឡែកទេ។

ការផ្ទៀងផ្ទាត់

រាល់សំណើត្រូវបានផ្ទៀងផ្ទាត់ដោយកូនសោ API របស់អ្នកជាថូខិន Bearer។ បង្កើតកូនសោក្នុងកម្មវិធីនៅក្រោម ការកំណត់ រួចផ្ញើវាក្នុងក្បាល Authorization៖

ក្បាលសំណើ 
Authorization: Bearer sk_...

កូនសោត្រូវបានបង្ហាញម្តង នៅពេលបង្កើត។ រក្សាវាជាការសម្ងាត់។ URL មូលដ្ឋានសម្រាប់រាល់ endpoint គឺ https://sketchie.ai/api។

ការចាប់ផ្តើមរហ័ស

1. បង្កើតវីដេអូពន្យល់

ផ្ញើប្រធានបទរបស់អ្នកជា input និងរយៈពេលគោលដៅជាជម្រើសជា length (ខ្សែអក្សរ "M:SS" ងាយស្រួលដូចជា "0:30" ឬ "1:00" ជាជំហាន 30 វិនាទី)។ លុប length សម្រាប់រយៈពេលស្វ័យប្រវត្តិ។

Terminal 
curl -X POST https://sketchie.ai/api/v1/explainer \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Explain how DNS resolves a domain name",
    "length": "0:30"
  }'

ការហៅត្រឡប់ 202 Accepted ភ្លាមៗ ជាមួយកំណត់ត្រាដែលនៅក្នុងជួរ។ ការ render ដំណើរការនៅផ្ទៃខាងក្រោយ ហើយចំណាយពេលពីរបីនាទី។

202 Accepted 
{
  "id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
  "status": "queued",
  "prompt": "Explain how DNS resolves a domain name",
  "lengthSeconds": 30,
  "voice": "sketchie:sulafat",
  "language": "en",
  "aspect": "16:9",
  "videoUrl": null,
  "sceneGraph": null
}

2. poll សម្រាប់លទ្ធផល

ទាញយកវីដេអូពន្យល់តាម id រហូតដល់ status របស់វាឈានដល់ស្ថានភាពចុងក្រោយ។ វដ្តជីវិតគឺ queued, បន្ទាប់មក generating, បន្ទាប់មក rendering, បន្ទាប់មក ready (រួចរាល់) ឬ failed។

Terminal 
curl https://sketchie.ai/api/v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b \
  -H "Authorization: Bearer sk_..."

នៅពេលវាជា ready, កំណត់ត្រាផ្ទុក URL វីដេអូ និង scene graph ដែលអាចកែសម្រួលបាន៖

200 OK 
{
  "id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
  "status": "ready",
  "videoUrl": "https://sketchie.ai/media/....mp4",
  "sceneGraph": { "scenes": [ ... ] }
}

ឈ្មោះវាលងាយស្រួល និងបុរាណ។ input និង length គឺជាវាលសំណើងាយស្រួល។ prompt (ខ្សែអក្សរ) និង lengthSeconds (លេខ ពហុគុណវិជ្ជមាននៃ 30) ចាស់នៅតែត្រូវបានទទួលយកជាឈ្មោះក្លែងក្លាយ ដូច្នេះការរួមបញ្ចូលដែលមានស្រាប់នៅតែដំណើរការ។ នៅពេលផ្ញើទាំងពីរ វាលងាយស្រួលឈ្នះ។

ទៅណាបន្ទាប់

  • ឯកសារយោង API . រាល់ endpoint ជាមួយទម្រង់សំណើ និងការឆ្លើយតបរបស់វា។
  • សំឡេង . អ្នកនិទានលំនាំដើម, កាតាឡុកសំឡេងប្រាំមួយ, និងការមើលជាមុនដែលអាចចាក់បាន។
  • ភាសា . ភាសានិទាន 34 ដែលបានគាំទ្រ។
  • CLI និង SDK . បន្ទាត់ពាក្យបញ្ជា sketchie និងម៉ាស៊ីនភ្ញៀវ TypeScript @sketchie/sdk។
  • ការដំឡើង MCP . ប្រើ Sketchie ជាឧបករណ៍ក្នុង Claude Desktop, Claude Code និងកម្មវិធី Claude។