అవలోకనం మరియు క్విక్‌స్టార్ట్

Sketchie ఒక prompt లేదా పత్రాన్ని వైట్‌బోర్డ్ వివరణ వీడియోగా మారుస్తుంది, మరియు రెండర్ చేసిన వీడియో మరియు దాని సవరించదగిన scene graph రెండింటినీ మీకు తిరిగి ఇస్తుంది. ఇది HTTP API, CLI, TypeScript SDK మరియు MCP సర్వర్ కోసం సూచన.

ప్రతి చెల్లింపు ప్లాన్‌లో API యాక్సెస్ చేర్చబడింది. ప్లాన్ పొందిన తర్వాత యాప్‌లోని సెట్టింగ్‌ల నుండి ఒక API కీని రూపొందించండి. API జనరేషన్‌లు యాప్‌లాగే అదే రేటుతో మీ ప్లాన్ నిమిషాలను వాడతాయి. ప్రత్యేక API ధర లేదు.

ప్రామాణీకరణ

ప్రతి అభ్యర్థన మీ API కీని Bearer టోకెన్‌గా ప్రామాణీకరిస్తుంది. యాప్‌లో సెట్టింగ్‌ల కింద ఒక కీని రూపొందించి, ఆపై దానిని Authorization హెడర్‌లో పంపండి:

అభ్యర్థన హెడర్ 
Authorization: Bearer sk_...

కీ రూపొందించేటప్పుడు ఒకసారి చూపబడుతుంది. దీన్ని రహస్యంగా ఉంచండి. ప్రతి endpoint కోసం బేస్ URL https://sketchie.ai/api.

క్విక్‌స్టార్ట్

1. ఒక వివరణ వీడియోను రూపొందించండి

మీ అంశాన్ని inputగా మరియు ఐచ్ఛిక లక్ష్య నిడివిని lengthగా పంపండి ("0:30" లేదా "1:00" వంటి సులభమైన "M:SS" స్ట్రింగ్, 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. ఫలితం కోసం poll చేయండి

వివరణ వీడియోను దాని status ఒక ముగింపు స్థితికి చేరుకునే వరకు id ద్వారా పొందండి. జీవితచక్రం: 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 సూచన . ప్రతి endpoint, దాని అభ్యర్థన మరియు ప్రతిస్పందన రూపాలతో.
  • వాయిస్‌లు . డిఫాల్ట్ కథకుడు, ఆరు-వాయిస్ కేటలాగ్, మరియు ప్లే చేయగల ప్రివ్యూలు.
  • భాషలు . మద్దతు ఉన్న 34 కథన భాషలు.
  • CLI మరియు SDK . sketchie కమాండ్ లైన్ మరియు @sketchie/sdk TypeScript క్లయింట్.
  • MCP సెటప్ . Sketchieను Claude Desktop, Claude Code మరియు Claude యాప్‌లో సాధనాలుగా ఉపయోగించండి.