डॉक्स / परिचय और क्विकस्टार्ट

यहां से शुरू करें

परिचय और क्विकस्टार्ट

Chasca ऐप में आप जो कुछ भी कर सकते हैं, वह सब HTTP से भी कर सकते हैं: प्रॉम्प्ट या डॉक्यूमेंट से नैरेशन वाला व्हाइटबोर्ड एक्सप्लेनर बनाएं, उसके तैयार होने का इंतज़ार करें, और फिर उसमें एक बार में एक चीज़ बदलें या उसका सीन ग्राफ़ एडिट करें। SDK, CLI और MCP सर्वर इसी API के ऊपर बनी पतली परतें हैं।

बेस URL https://app.trychasca.com/api

1. API key लें

ऐप में Settings → API keys खोलें और एक key बनाएं। यह key chk_live_… जैसी दिखती है और सिर्फ़ एक बार दिखाई जाती है, इसलिए इसे किसी सुरक्षित जगह रख लें (एनवायरनमेंट वेरिएबल इसके लिए सबसे अच्छी जगह है)।

  • API एक्सेस Plus और उससे ऊपर के प्लान में शामिल है। प्लान की तुलना करें।
  • API key से बने वीडियो, यानी API, SDK और CLI, या key वाले MCP सर्वर से बने वीडियो में आपके प्लान के मिनट 2x खर्च होते हैं: 1 मिनट के वीडियो में 2 मिनट लगते हैं। Claude और दूसरे असिस्टेंट के लिए कनेक्टर, जो आपके अकाउंट में साइन इन करता है, हर प्लान पर काम करता है और उसकी गिनती ऐप जैसी ही होती है।

2. ऑथेंटिकेट करें

हर रिक्वेस्ट में key को bearer token के रूप में भेजें:

हेडर
Authorization: Bearer chk_live_...

सभी रिक्वेस्ट और रिस्पॉन्स की बॉडी JSON में होती है। API का पता https://app.trychasca.com/api है।

3. एक्सप्लेनर बनाएं

आप जो समझाना चाहते हैं, उसे input में भेजें: कोई टॉपिक, कोई सवाल या किसी डॉक्यूमेंट का पूरा टेक्स्ट। लंबाई के लिए length भेजें: 30-30 सेकंड के स्टेप में, 30:00 तक। या इसे छोड़ दें, तो Chasca खुद लंबाई चुन लेगा।

टर्मिनल
curl -X POST https://app.trychasca.com/api/v1/explainer \
  -H "Authorization: Bearer $CHASCA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Explain how vaccines train the immune system",
    "length": "1:00",
    "aspect": "16:9",
    "preset": "marker"
  }'

API तुरंत 202 Accepted लौटाता है, साथ में वह रिकॉर्ड, जो अब कतार में है। वीडियो बैकग्राउंड में बनता है।

202 Accepted (संक्षिप्त)
{
  "id": "0b9c6f2e-5d1a-4c3e-9a47-2f8e1c7d4b60",
  "status": "queued",
  "stage": null,
  "progress": 0,
  "prompt": "Explain how vaccines train the immune system",
  "lengthSeconds": 60,
  "voice": "chasca:sulafat",
  "language": "en",
  "aspect": "16:9",
  "preset": "marker",
  "videoUrl": null,
  "createdVia": "api",
  "createdAt": "2026-09-23T09:14:02.118Z"
}

4. तैयार होने का इंतज़ार करें

एक्सप्लेनर को तब तक poll करें, जब तक status की वैल्यू ready न हो जाए। स्टेटस इस क्रम में बदलता है: queued → generating → rendering → ready (या failed, और तब error में साफ़ शब्दों में वजह लिखी होती है)। ज़्यादातर वीडियो एक मिनट से कम में तैयार हो जाते हैं। अगर आप poll नहीं करना चाहते, तो इवेंट स्ट्रीम सब्सक्राइब करें।

टर्मिनल
curl https://app.trychasca.com/api/v1/explainer/0b9c6f2e-5d1a-4c3e-9a47-2f8e1c7d4b60 \
  -H "Authorization: Bearer $CHASCA_API_KEY"

तैयार एक्सप्लेनर में videoUrl, posterUrl और subtitlesUrl होते हैं, साथ ही पूरा, एडिट किया जा सकने वाला sceneGraph, हर वर्ज़न और हर सीन की टाइमिंग। मीडिया लिंक signed URL होते हैं और करीब एक हफ़्ते बाद एक्सपायर हो जाते हैं; नए लिंक पाने के लिए एक्सप्लेनर को दोबारा fetch करें।

5. एक चीज़ बदलें

एक बदलाव भेजें, और बाकी सब बिल्कुल वैसा ही रहता है। सबटाइटल, बोर्ड स्टाइल, म्यूज़िक, वॉटरमार्क, लोगो और क्रेडिट लाइन से उसी वीडियो का एक फ़्री नया वर्ज़न बनता है, उसी नैरेशन के साथ। नई आवाज़ या नया फ़ॉर्मेट चुनें, तो उसी स्क्रिप्ट और ड्रॉइंग से एक अलग वीडियो बनता है, जिसका खर्च नए वीडियो जितना ही होता है।

टर्मिनल
curl -X POST https://app.trychasca.com/api/v1/explainer/0b9c6f2e-5d1a-4c3e-9a47-2f8e1c7d4b60/change \
  -H "Authorization: Bearer $CHASCA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "kind": "captions", "captions": true, "captionStyle": "bold" }'

शब्द या ड्रॉइंग बदलनी हो, तो एक्सप्लेनर का sceneGraph अपने बदलावों के साथ edit पर वापस भेजें: सिर्फ़ बदले हुए सीन फिर से बनते हैं। दोनों में से कोई भी बदलाव revert से वापस लिया जा सकता है।

TypeScript पसंद है?

SDK यह सब खुद संभालता है: इंतज़ार, ज़रूरत पड़ने पर दोबारा कोशिश, और typed रिस्पॉन्स। ज़्यादा जानकारी के लिए CLI और SDK देखें। Claude, Cursor या किसी दूसरे एजेंट से Chasca चलवाना हो, तो MCP सेटअप देखें।

quickstart.ts
import { ChascaClient } from '@chasca/sdk';

const chasca = new ChascaClient({ apiKey: process.env.CHASCA_API_KEY! });

const job = await chasca.createExplainer({ input: 'How compound interest snowballs', length: '1:00' });
const video = await chasca.waitForExplainer(job.id);
console.log(video.videoUrl);

लिमिट, एक नज़र में

  • जनरेशन, बदलाव और एडिट की रिक्वेस्ट: हर मिनट 20। बाकी सभी रिक्वेस्ट: हर मिनट 200।
  • वीडियो की लंबाई: 30 सेकंड से 30 मिनट तक, 30-30 सेकंड के स्टेप में। 6 मिनट से लंबा वीडियो चैप्टर में बंट जाता है, और आपके बचे हुए मिनट उतने होने चाहिए, जितनी लंबाई आप मांगते हैं।
  • एरर हमेशा एक ही रूप में आते हैं: { "error": true, "code": "...", "message": "...", "status": 400 }। एरर देखें।