Ikuspegi orokorra eta hasiera azkarra

Sketchie-k prompt bat edo dokumentu bat arbel azalpen-bideo bihurtzen du, eta errenderizatutako bideoa zein bere scene graph editagarria itzultzen dizkizu. Hau HTTP APIaren, CLIaren, TypeScript SDKaren eta MCP zerbitzariaren erreferentzia da.

APIrako sarbidea ordainpeko plan guztietan sartuta dago. Sortu API gako bat aplikazioko Ezarpenetatik plan bat duzunean. API bidezko sorkuntzek zure planeko minutuak erabiltzen dituzte aplikazioak bezalako tasa berean. Ez dago API prezio bereizirik.

Autentifikazioa

Eskaera bakoitza zure API gakoarekin autentifikatzen da Bearer token gisa. Sortu gako bat aplikazioan Ezarpenak atalean, eta bidali ezazu Authorization goiburuan:

Eskaeraren goiburua 
Authorization: Bearer sk_...

Gakoa behin erakusten da, sortzean. Gorde ezazu isilpean. Endpoint bakoitzaren oinarrizko URLa https://sketchie.ai/api da.

Hasiera azkarra

1. Sortu azalpen bat

Bidali zure gaia input gisa eta aukerako helburu-luzera bat length gisa ("0:30" edo "1:00" bezalako "M:SS" kate atsegin bat, 30 segundoko urratsetan). Utzi length luzera automatikoarako.

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

Deiak 202 Accepted itzultzen du berehala ilaran dagoen erregistro batekin. Errenderizazioa atzeko planoan exekutatzen da eta minutu batzuk behar ditu.

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. Galdetu emaitza

Eskuratu azalpena id bidez bere status egoera terminal batera iritsi arte. Bizi-zikloa queued da, gero generating, gero rendering, gero ready (eginda) edo failed.

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

ready denean, erregistroak bideoaren URLa eta scene graph editagarria darama:

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

Eremu-izen atseginak eta klasikoak. input eta length eskaera-eremu atseginak dira. prompt (katea) eta lengthSeconds (zenbaki bat, 30en multiplo positiboa) zaharragoak oraindik alias gisa onartzen dira, beraz lehendik dauden integrazioek funtzionatzen jarraitzen dute. Biak bidaltzen direnean, eremu atseginak irabazten du.

Nora joan hurrengoan

  • APIaren erreferentzia . Endpoint bakoitza, bere eskaera eta erantzun formekin.
  • Ahotsak . Kontalari lehenetsia, sei ahotsen katalogoa eta erreproduzi daitezkeen aurrebistak.
  • Hizkuntzak . Onartutako 34 narrazio-hizkuntzak.
  • CLI eta SDK . sketchie komando-lerroa eta @sketchie/sdk TypeScript bezeroa.
  • MCP konfigurazioa . Erabili Sketchie tresna gisa Claude Desktop, Claude Code eta Claude aplikazioan.