Агляд і хуткі старт

Sketchie ператварае prompt або дакумент у тлумачальнае відэа на дошцы і вяртае вам як адрэндэранае відэа, так і яго рэдагуемы scene graph. Гэта даведнік па HTTP API, CLI, TypeScript SDK і серверы MCP.

Доступ да API уваходзіць у кожны платны план. Стварыце ключ API у Наладах у праграме, калі ў вас ёсць план. Генерацыі праз API расходуюць хвіліны вашага плана па той жа стаўцы, што і праграма. Асобнай цаны на API няма.

Аўтэнтыфікацыя

Кожны запыт аўтэнтыфікуецца вашым ключом API як токенам Bearer. Стварыце ключ у праграме ў Наладах, потым дасылайце яго ў загалоўку Authorization:

Загаловак запыту 
Authorization: Bearer sk_...

Ключ паказваецца адзін раз, пры стварэнні. Трымайце яго ў сакрэце. Базавы URL для кожнай канчатковай кропкі — https://sketchie.ai/api.

Хуткі старт

1. Стварыце тлумачэнне

Дашліце сваю тэму як input і неабавязковую мэтавую працягласць як length (зручны радок "M:SS", напрыклад "0:30" або "1:00", з крокам 30 секунд). Прапусціце length для аўтаматычнай працягласці.

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

Выклік адразу вяртае 202 Accepted з запісам у чарзе. Рэндэрынг выконваецца ў фоне і займае некалькі хвілін.

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. Апытвайце вынік

Атрымлівайце тлумачэнне па id, пакуль яго status не дасягне канчатковага стану. Жыццёвы цыкл: queued, потым generating, потым rendering, потым ready (гатова) або failed.

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

Калі яно ready, запіс нясе URL відэа і рэдагуемы scene graph:

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

Зручныя і класічныя назвы палёў. input і length — зручныя палі запыту. Ранейшыя prompt (радок) і lengthSeconds (лік, дадатны кратны 30) па-ранейшаму прымаюцца як псеўданімы, таму існуючыя інтэграцыі працягваюць працаваць. Калі дасланы абодва, перамагае зручнае поле.

Куды далей

  • Даведнік API . Кожная канчатковая кропка з формамі запыту і адказу.
  • Галасы . Апавядальнік па змаўчанні, каталог з шасці галасоў і прайграванні для праслухоўвання.
  • Мовы . 34 падтрымліваныя мовы агучкі.
  • CLI і SDK . Камандны радок sketchie і кліент @sketchie/sdk на TypeScript.
  • Наладжванне MCP . Выкарыстоўвайце Sketchie як інструменты ў Claude Desktop, Claude Code і праграме Claude.