Apžvalga ir greita pradžia

Sketchie paverčia užklausą arba dokumentą baltos lentos aiškinamuoju vaizdo įrašu ir grąžina jums tiek atvaizduotą vaizdo įrašą, tiek jo redaguojamą scene graph. Tai HTTP API, CLI, TypeScript SDK ir MCP serverio nuoroda.

API prieiga įtraukta į kiekvieną mokamą planą. Sukurkite API raktą programėlės Nustatymuose, kai turite planą. API generavimai naudoja jūsų plano minutes tokiu pačiu tarifu kaip programėlė. Atskiros API kainos nėra.

Autentifikacija

Kiekviena užklausa autentifikuojama jūsų API raktu kaip Bearer prieigos raktu. Sukurkite raktą programėlėje skiltyje Nustatymai, tada siųskite jį antraštėje Authorization:

Užklausos antraštė 
Authorization: Bearer sk_...

Raktas parodomas vieną kartą, kuriant. Laikykite jį paslaptyje. Kiekvieno galinio taško bazinis URL yra https://sketchie.ai/api.

Greita pradžia

1. Sukurkite aiškinimą

Siųskite savo temą kaip input ir neprivalomą tikslinį ilgį kaip length (patogi "M:SS" eilutė, pvz., "0:30" arba "1:00", 30 sekundžių žingsniais). Praleiskite length, kad ilgis būtų automatinis.

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

Iškvietimas iškart grąžina 202 Accepted su eilėje esančiu įrašu. Atvaizdavimas vyksta fone ir trunka kelias minutes.

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. Apklauskite rezultatą

Gaukite aiškinimą pagal id, kol jo status pasieks galutinę būseną. Gyvavimo ciklas yra queued, tada generating, tada rendering, tada ready (baigta) arba failed.

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

Kai jis ready, įrašas neša vaizdo įrašo URL ir redaguojamą scene graph:

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

Patogūs ir klasikiniai laukų pavadinimai. input ir length yra patogūs užklausos laukai. Senesni prompt (eilutė) ir lengthSeconds (skaičius, teigiamas 30 kartotinis) vis dar priimami kaip pseudonimai, todėl esamos integracijos toliau veikia. Kai siunčiami abu, laimi patogus laukas.

Kur eiti toliau

  • API nuoroda . Kiekvienas galinis taškas su užklausos ir atsakymo formomis.
  • Balsai . Numatytasis pasakotojas, šešių balsų katalogas ir grojami peržiūrimieji.
  • Kalbos . 34 palaikomos pasakojimo kalbos.
  • CLI ir SDK . sketchie komandų eilutė ir @sketchie/sdk TypeScript klientas.
  • MCP sąranka . Naudokite Sketchie kaip įrankius Claude Desktop, Claude Code ir Claude programėlėje.