Apèsi ak kòmanse rapid

Sketchie transfòme yon prompt oswa yon dokiman an yon videyo eksplikasyon tablo blan, epi li remèt ou tou de videyo ki rann lan ak scene graph ki ka modifye a. Sa a se referans lan pou HTTP API, CLI, TypeScript SDK, ak sèvè MCP.

Aksè API enkli nan chak plan peye. Kreye yon kle API soti nan Paramèt nan app la yon fwa ou gen yon plan. Jenerasyon API yo rale nan minit plan ou yo nan menm to ak app la. Pa gen okenn pri API separe.

Otantifikasyon

Chak demann otantifye ak kle API ou an kòm yon token Bearer. Kreye yon kle nan app la anba Paramèt, epi voye li nan antèt Authorization la:

Antèt demann 
Authorization: Bearer sk_...

Kle a montre yon sèl fwa, lè li kreye. Kenbe li sekrè. URL baz pou chak endpoint se https://sketchie.ai/api.

Kòmanse rapid

1. Kreye yon eksplikasyon

Voye sijè ou an kòm input ak yon longè sib opsyonèl kòm length (yon chèn "M:SS" senp tankou "0:30" oswa "1:00", nan etap 30 segond). Kite length deyò pou longè otomatik.

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

Apèl la retounen 202 Accepted imedyatman ak yon dosye nan fil datant. Rannman an ap kouri an background epi li pran kèk minit.

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 pou rezilta a

Rekipere eksplikasyon an pa id jiskaske status li rive nan yon eta final. Sik lavi a se queued, apre generating, apre rendering, apre ready (fini) oswa failed.

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

Lè li ready, dosye a pote URL videyo a ak scene graph ki ka modifye a:

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

Non jaden zanmitay ak klasik. input ak length se jaden demann zanmitay yo. Ansyen prompt (chèn) ak lengthSeconds (yon nonm, miltip pozitif 30) toujou aksepte kòm alyas, kidonk entegrasyon ki egziste yo kontinye travay. Lè tou de voye, jaden zanmitay la genyen.

Ki kote pou ale apre

  • Referans API . Chak endpoint, ak fòm demann ak repons li yo.
  • Vwa . Naratè default la, katalòg sis vwa a, ak apèsi ou ka jwe.
  • Lang . 34 lang naratif ki sipòte yo.
  • CLI ak SDK . Liy kòmandman sketchie a ak kliyan TypeScript @sketchie/sdk la.
  • Konfigirasyon MCP . Sèvi ak Sketchie kòm zouti nan Claude Desktop, Claude Code, ak app Claude la.