LOADING
API REST كاملة لأتمتة إنتاج إعلانات الفيديو. مصادقة بسيطة، نقاط نهاية قوية، webhooks فورية.
Base URL: https://cinematicads.studio
OpenAPI 3.1: openapi.json (72 مسار, 99 عملية)
تتطلب جميع طلبات API رمز Bearer في رأس Authorization. احصل على مفتاح API من إعدادات حسابك.
تستخدم جلسات الويب ملفات تعريف ارتباط HTTP-Only. يستخدم عملاء API الخارجيون رأس Bearer.
Authorization: Bearer YOUR_API_KEY
يستهلك كل سير عمل رصيداً. تعتمد التكلفة على النوع ومستوى الجودة.
مستويات الجودة:
| Workflow | Standard | Premium |
|---|---|---|
| المخرج (cinematic) | 1 | 2 |
| المقدم (avatar) | 2 | 3 |
| متعدد الصيغ (factory) | 3 | 5 |
| الاستلهام (clone) | 3 | 5 |
| المؤثر | 8 | 15 |
| استنساخ العلامة | 15 | 25 |
| إعلان ثابت | 1 | 1 |
| نقطة الألم | 1 | 1 |
| محسّن الإعلانات | 1 | 2 |
| تدقيق محلي | 2 | 3 |
/api/workflow Authيطلق سير عمل إنتاج فيديو. يُرجع jobId للمتابعة الفورية.
typestringمطلوبالنوع: avatar | cinematic | clone | factory | influencer | brand | staticad | painpoint | ad-optimizerurlstringرابط المصدر (إلزامي لـ clone/factory)conceptstringالمفهوم الإبداعي (لـ cinematic/brand)qualitystringالمستوى: standard (افتراضي) | premiumasyncbooleanوضع غير متزامن (افتراضي: true). يُرجع jobId فوراً./api/workflow/stream?jobId={id} Authاتصال Server-Sent Events للمتابعة الفورية لسير العمل.
jobIdstringمطلوبمعرّف المهمة من POST /api/workflow/api/batch/status?batchId={id} Authيُرجع حالة دفعة سير العمل.
batchIdstringمطلوبمعرّف الدفعةcurl -X POST https://cinematicads.studio/api/workflow \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "cinematic",
"concept": "Luxury perfume ad with golden tones",
"quality": "premium",
"formats": "9:16,1:1",
"async": true
}'{
"success": true,
"jobId": "wf_abc123xyz",
"message": "Workflow queued",
"cost": 2
}curl -N "https://cinematicads.studio/api/workflow/stream?jobId=wf_abc123xyz" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: text/event-stream"
event: step
data: {"step":"art_direction","status":"completed","progress":20}
event: step
data: {"step":"video_generation","status":"completed","progress":60}
event: result
data: {"success":true,"videoUrl":"https://...","duration":15}/api/user/credits Authيُرجع رصيد المستخدم الحالي.
/api/user/stats Authيُرجع إحصائيات المستخدم: المشاريع حسب النوع، الرصيد المستخدم، معدل النجاح.
/api/user/projects Authيُرجع جميع مشاريع المستخدم مرتبة حسب التاريخ.
/api/user/brand Authيُرجع ملف العلامة التجارية (الاسم، الألوان، النبرة، القطاع، الجمهور).
/api/user/brand Authينشئ أو يحدّث ملف العلامة التجارية.
namestringمطلوباسم العلامة التجاريةindustrystringقطاع النشاط/api/models/statusيُرجع حالة جميع نماذج الذكاء الاصطناعي وتوفرها.
استقبل إشعارات فورية عبر Server-Sent Events (SSE) أو webhooks HTTP.
workflow.startedبدأ سير العملworkflow.stepاكتملت خطوة من سير العمل (تحديث التقدم)workflow.completedاكتمل سير العمل بنجاحworkflow.failedفشل سير العمل (يُعاد الرصيد تلقائياً)video.readyالفيديو جاهز للتحميلworkflow.suspendedسير العمل بانتظار المراجعة البشرية (HITL)تستخدم API رموز HTTP القياسية. جميع الردود تتبع التنسيق { success, data?, error? }.
| Code | Description |
|---|---|
| 200 | نجاح |
| 400 | طلب غير صالح (معامل مفقود أو تنسيق خاطئ) |
| 401 | غير مصادق (رمز مفقود أو منتهي الصلاحية) |
| 402 | رصيد غير كافٍ أو فترة التجربة منتهية |
| 403 | ممنوع (سير عمل محجوز أو مورد مقيّد) |
| 404 | المورد غير موجود |
| 429 | تم تجاوز حد الطلبات (راجع حدود الطلبات) |
| 500 | خطأ داخلي في الخادم |
| 503 | الخدمة غير متوفرة مؤقتاً (طابور/Redis) |
{
"success": false,
"error": "Insufficient credits. Required: 2, available: 0"
}تطبق API حدود طلبات لكل نقطة نهاية لضمان استقرار الخدمة.
10 طلبات/ساعة10 اتصالات/ساعة100 طلب/دقيقةتتضمن رؤوس الاستجابة:
X-RateLimit-Limit: 100 X-RateLimit-Remaining: 97 X-RateLimit-Reset: 1709312400
مكتبات عملاء لدمج CinematicAds بسرعة.
npm install @cinematicads/sdkpip install cinematicadscurl -X POST https://cinematicads.studio/api/workflowمتوفر في خطط Agency وEnterprise.
احصل على مفتاح API