Ringkesan lan wiwitan cepet

Sketchie ngowahi prompt utawa dokumen dadi video panjelasan papan putih, lan mbalekake marang sampeyan video sing wis dirrender lan scene graph sing bisa disunting. Iki referensi kanggo HTTP API, CLI, TypeScript SDK, lan server MCP.

Akses API kalebu ing saben paket mbayar. Gawe kunci API saka Setelan ing app sawise sampeyan duwe paket. Generasi API njupuk saka menit paket sampeyan kanthi tarif sing padha karo app. Ora ana rega API kapisah.

Otentikasi

Saben panjaluk diotentikasi nganggo kunci API sampeyan minangka token Bearer. Gawe kunci ing app ing sangisore Setelan, banjur kirim ing header Authorization:

Header panjaluk 
Authorization: Bearer sk_...

Kunci ditampilake sepisan, nalika digawe. Simpen rahasia. URL dhasar kanggo saben endpoint yaiku https://sketchie.ai/api.

Wiwitan cepet

1. Gawe panjelasan

Kirim topik sampeyan minangka input lan dawa target opsional minangka length (senar "M:SS" sing ramah kaya "0:30" utawa "1:00", ing langkah 30 detik). Ilangi length kanggo dawa otomatis.

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"
  }'

Panggilan mbalekake 202 Accepted langsung karo rekaman ing antrian. Rendering mlaku ing latar mburi lan njupuk sawetara menit.

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 kanggo asil

Jupuk panjelasan miturut id nganti status-e tekan kahanan pungkasan. Siklus urip yaiku queued, banjur generating, banjur rendering, banjur ready (rampung) utawa failed.

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

Nalika ready, rekaman nggawa URL video lan scene graph sing bisa disunting:

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

Jeneng ruas sing ramah lan klasik. input lan length yaiku ruas panjaluk sing ramah. prompt (senar) lan lengthSeconds (angka, kelipatan positif 30) sing luwih lawas isih ditampa minangka alias, mula integrasi sing wis ana tetep mlaku. Nalika loro-lorone dikirim, ruas sing ramah menang.

Menyang endi sabanjure

  • Referensi API . Saben endpoint, karo wangun panjaluk lan wangsulan.
  • Swara . Narator standar, katalog nem swara, lan pratinjau sing bisa diputer.
  • Basa . 34 basa narasi sing didhukung.
  • CLI lan SDK . Baris printah sketchie lan klien TypeScript @sketchie/sdk.
  • Persiapan MCP . Gunakake Sketchie minangka alat ing Claude Desktop, Claude Code, lan app Claude.