ਸੰਖੇਪ ਜਾਣਕਾਰੀ ਅਤੇ ਕਵਿੱਕਸਟਾਰਟ

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 ਐਪ ਵਿੱਚ ਟੂਲਾਂ ਵਜੋਂ ਵਰਤੋ।