Ընդհանուր ակնարկ և արագ սկիզբ

Նույնականացում

Յուրաքանչյուր հարցում նույնականացվում է ձեր API բանալիով՝ որպես Bearer նշան։ Ստեղծեք բանալի հավելվածում Կարգավորումների ներքո, ապա ուղարկեք այն Authorization վերնագրում:

Authorization: Bearer sk_...

Բանալին ցուցադրվում է մեկ անգամ՝ ստեղծման ժամանակ։ Պահեք այն գաղտնի։ Յուրաքանչյուր endpoint-ի հիմնական URL-ն է https://sketchie.ai/api։

Արագ սկիզբ

1. Ստեղծեք բացատրություն

Ուղարկեք ձեր թեման որպես input և ընտրովի նպատակային տևողություն որպես length (հարմար "M:SS" տող, ինչպես "0:30" կամ "1:00", 30 վայրկյան քայլերով)։ Բաց թողեք length-ը ավտոմատ տևողության համար։

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 հերթում գտնվող գրառմամբ։ Մշակումը ընթանում է ֆոնում և տևում է մի քանի րոպե։

{
  "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։

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

Երբ այն ready է, գրառումը կրում է տեսանյութի URL-ը և խմբագրելի scene graph-ը:

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

Ուր գնալ հետո

• API հղում . Յուրաքանչյուր endpoint՝ իր հարցման և պատասխանի ձևերով։
• Ձայներ . Կանխադրված պատմողը, վեց ձայնի կատալոգը և նվագարկվող նախադիտումները։
• Լեզուներ . 34 աջակցվող պատմողական լեզու։
• CLI և SDK . sketchie հրամանի տողը և @sketchie/sdk TypeScript հաճախորդը։
• MCP կարգավորում . Օգտագործեք Sketchie-ն որպես գործիքներ Claude Desktop-ում, Claude Code-ում և Claude հավելվածում։