અવલોકન અને ક્વિકસ્ટાર્ટ

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 ઍપમાં સાધનો તરીકે વાપરો.