نظرة عامة وبدء سريع

1. احصل على مفتاح API

في التطبيق، افتح Settings → API keys وأنشئ مفتاحًا. تكون المفاتيح على شكل chk_live_… ولا تُعرض إلا مرة واحدة، لذا احفظ مفتاحك في مكان آمن (ومتغير البيئة مكان مثالي له).

• الوصول إلى API مشمول في خطة Plus وما فوقها. قارن الخطط.
• الفيديوهات المُنشأة بمفتاح API، عبر واجهة API أو SDK وCLI أو خادم MCP الذي يعمل بالمفتاح، تستهلك دقائق خطتك مضروبةً في 2: فالفيديو الذي مدته دقيقة واحدة يستهلك دقيقتين. أما الموصِّل الخاص بـClaude والمساعدات الأخرى، الذي يسجّل الدخول إلى حسابك، فيعمل في كل الخطط وتُحتسب فيه الفيديوهات كما في التطبيق.

2. أضف المصادقة إلى طلباتك

أرسل المفتاح مع كل طلب بوصفه رمزًا من نوع Bearer:

Authorization: Bearer chk_live_...

أجسام كل الطلبات والاستجابات بصيغة JSON. وتعمل واجهة API على العنوان https://app.trychasca.com/api.

3. أنشئ فيديو شرح

أرسل ما تريد شرحه في الحقل input: موضوعًا، أو سؤالًا، أو النص الكامل لمستند. واختر قيمة length بخطوات من 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، مع سجل فيديو الشرح الجديد في قائمة الانتظار. ويجري الإنشاء في الخلفية.

{
  "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. انتظر اكتماله

استعلم دوريًا عن فيديو الشرح حتى تصبح قيمة status هي ready. تنتقل الحالة عبر queued → generating → rendering → ready (أو تنتهي بـfailed مع رسالة error مفهومة). تجهز معظم الفيديوهات في أقل من دقيقة. وإن كنت تفضّل ألا تستعلم دوريًا، فاشترك في تدفق الأحداث.

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

يتضمن فيديو الشرح الجاهز videoUrl وposterUrl وsubtitlesUrl، إضافةً إلى sceneGraph الكامل القابل للتعديل، وكل الإصدارات، وتوقيت كل مشهد. روابط الوسائط موقَّعة وتنتهي صلاحيتها بعد أسبوع تقريبًا، فاجلب فيديو الشرح مجددًا للحصول على روابط جديدة.

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، فلا يُعاد رسم إلا المشاهد التي تغيّرت. ويمكنك التراجع عن أيٍّ منهما باستعادة إصدار سابق.

تفضّل TypeScript؟

تغلّف حزمة SDK كل ما سبق، بما في ذلك الانتظار وإعادة المحاولة والاستجابات المُعرَّفة الأنواع. راجع أداة CLI وحزمة SDK. ولتمكين Claude أو Cursor أو أي وكيل آخر من استخدام Chasca نيابةً عنك، راجع إعداد MCP.

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 ثانية. وبعد 6 دقائق يُروى الفيديو في فصول، ويجب أن تكفي دقائقك المتبقية للمدة التي تطلبها.
• للأخطاء الشكل نفسه دائمًا: { "error": true, "code": "...", "message": "...", "status": 400 }. راجع الأخطاء.