Topimaso sy fanombohana haingana

Sketchie dia manova prompt na antontan-taratasy ho lahatsary fanazavana solaitrabe, ary mamerina aminao ny lahatsary voarafitra sy ny scene graph azo ovaina aminy. Ity no fanovozan-kevitra ho an'ny HTTP API, ny CLI, ny TypeScript SDK, ary ny lohamilina MCP.

Tafiditra amin'ny drafitra andoavam-bola rehetra ny fidirana amin'ny API. Mamorona lakile API avy ao amin'ny Kirakira ao anaty app rehefa manana drafitra ianao. Ny famoronana amin'ny API dia maka minitra amin'ny drafitrao amin'ny tahan'ny mitovy amin'ny app. Tsy misy vidin'ny API misaraka.

Fanamarinana

Ny fangatahana tsirairay dia amarinina amin'ny lakile API-nao ho token Bearer. Mamorona lakile ao anaty app ao ambanin'ny Kirakira, avy eo alefaso ao amin'ny lohateny Authorization izy io:

Lohatenin'ny fangatahana 
Authorization: Bearer sk_...

Aseho indray mandeha ny lakile, rehefa noforonina. Tehirizo miafina izy io. Ny URL fototra ho an'ny endpoint tsirairay dia https://sketchie.ai/api.

Fanombohana haingana

1. Mamorona fanazavana

Alefaso ny lohahevitrao ho input ary halavana kendrena tsy voatery ho length (tady "M:SS" mora toy ny "0:30" na "1:00", amin'ny dingana 30 segondra). Esory ny length ho an'ny halavana mandeha ho azy.

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

Mamerina 202 Accepted avy hatrany ny antso miaraka amin'ny firaketana milahatra. Mandeha ao ambadika ny fandokoana ary maharitra minitra vitsivitsy.

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 ny valiny

Alaivo amin'ny id ny fanazavana mandra-pahatongan'ny status-ny amin'ny toe-javatra farany. Ny tsingerimpiainana dia queued, avy eo generating, avy eo rendering, avy eo ready (vita) na failed.

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

Rehefa ready izy io, ny firaketana dia mitondra ny URL video sy ny scene graph azo ovaina:

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

Anaran-tsaha mora sy mahazatra. input sy length no saha fangatahana mora. Ny prompt (tady) sy lengthSeconds (isa, mari-batana miompana amin'ny 30) taloha dia mbola ekena ho anaram-bositra, ka mitohy miasa ny fampidirana efa misy. Rehefa alefa izy roa, dia mandresy ny saha mora.

Aiza no aleha manaraka

  • Fanovozan-kevitra API . Ny endpoint tsirairay, miaraka amin'ny endriky ny fangatahana sy ny valiny.
  • Feo . Ny mpitantara raikitra, ny katalaogin'ny feo enina, sy ny topimaso azo alefa.
  • Fiteny . Ny fiteny fitantarana 34 tohanana.
  • CLI sy SDK . Ny andalana baiko sketchie sy ny mpanjifa TypeScript @sketchie/sdk.
  • Fandrafetana MCP . Ampiasao ho fitaovana ao amin'ny Claude Desktop, Claude Code ary ny app Claude ny Sketchie.