UGC Arabia API

# Quick Start

ابدأ بإنتاج فيديو UGC كامل في 3 خطوات فقط:

🔑

1. احصل على API Key

تواصل معنا عبر تليجرام للحصول على مفتاح API خاص بك

🎬

2. أرسل طلب إنشاء

حدد النص واللهجة والمشهد — ونحن نتولى الباقي

📱

3. استلم الفيديو

فيديو جاهز للنشر خلال دقائق مع رابط تحميل مباشر

bash

# مثال: إنشاء فيديو UGC كامل بطلب واحد
curl -X POST https://api.cortexlow.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "face_prompt": "Saudi woman, hijab, gold pins, warm smile, natural lighting",
    "motion_prompt": "woman applying skincare cream, smiling, natural hand movements",
    "script_text": "بنات هالمنتج غير حياتي، بشرة نظيفة بدون فلتر",
    "dialect": "SAU",
    "voice": "noura",
    "motion_engine": "kling",
    "face_gen": "kora",
    "aspect_ratio": "9:16"
  }'

✅ الرد — 200 OK

{
  "job_id": "job_a1b2c3d4e5",
  "status": "processing",
  "estimated_time": 180,
  "check_url": "https://api.cortexlow.com/api/status/job_a1b2c3d4e5"
}

# المصادقة

جميع الطلبات تحتاج API Key في الهيدر:

http

Authorization: Bearer YOUR_API_KEY

تواصل معنا عبر تليجرام للحصول على مفتاح API.

# واجهات البرمجة

# إنشاء فيديو كامل

POST /api/generate

إنشاء فيديو UGC كامل — من الوجه حتى الفيديو النهائي مع صوت وشفة

المعامل	النوع	الوصف
face_prompt	string	وصف الشخصية (مثال: "Saudi woman, hijab, gold pins, warm smile")
motion_prompt	string	وصف الحركة (مثال: "woman applying cream, smiling")
script_text	string	النص العربي المراد نطقه
dialect	string	اللهجة: SAU, UAE, KUW, BHR, OMN, QAT
voice	string	اسم الصوت: noura, aisha, abdullah, fahad, sultan, lulwa
motion_engine	string	محرك الحركة: kling (افتراضي), veo3, seedance
face_gen	string	نوع الوجه: kora (أفضل جودة), flux (أسرع)
aspect_ratio	string	9:16 (افتراضي), 16:9, 1:1
product_image	string	رابط صورة المنتج (اختياري)
seed	int	بذرة ثابتة لنفس الوجه (اختياري)

# إنشاء وجه فقط

POST /api/generate-face

إنشاء صورة وجه AI فقط بدون تحريك — مناسب للتصاميم والمشاهد الثابتة

المعامل	النوع	الوصف
prompt	string	وصف الشخصية
face_gen	string	kora (أفضل جودة) أو flux
seed	int	بذرة ثابتة لنفس الوجه
width	int	عرض الصورة (افتراضي: 768)
height	int	ارتفاع الصورة (افتراضي: 1024)

# معاينة صوت

POST /api/voice-preview

تجربة الأصوات العربية قبل إنشاء الفيديو — إرسال نص واستلام ملف صوتي

المعامل	النوع	الوصف
text	string	النص المراد تحويله لصوت
voice	string	اسم الصوت: noura, aisha, abdullah, fahad, sultan, lulwa
dialect	string	SAU (افتراضي), UAE, KUW, BHR, OMN, QAT

# حالة الطلب

GET /api/status/{job_id}

متابعة حالة طلب إنشاء الفيديو

✅ الرد — 200 OK

{
  "job_id": "job_a1b2c3d4e5",
  "status": "completed",
  "progress": 100,
  "video_url": "https://api.cortexlow.com/api/output/job_a1b2c3d4e5.mp4",
  "thumbnail_url": "https://api.cortexlow.com/api/output/thumbs/job_a1b2c3d4e5.jpg",
  "duration_seconds": 15,
  "cost": 2.71,
  "created_at": "2026-06-08T01:00:00Z",
  "completed_at": "2026-06-08T01:03:00Z"
}

# المعرض

GET /api/gallery

عرض جميع الفيديوهات المنشأة — يرجع قائمة مع صور مصغرة

DELETE /api/gallery/{filename}

حذف فيديو من المعرض

# النصوص الجاهزة

GET /api/scripts

الحصول على نصوص تسويقية جاهزة باللهجة الخليجية

GET /api/scripts/random

نص عشوائي جاهز للاستخدام

# حالة الخدمات

GET /api/services

فحص حالة جميع خدمات الخلفية (TTS, Face Gen, Animation, Lip Sync)

✅ الرد — 200 OK

{
  "fal_ai": {"status": "active", "balance": "positive"},
  "enhancor": {"status": "active"},
  "orpheus_tts": {"status": "active", "voices": 6},
  "groq": {"status": "active"},
  "habibi_tts": {"status": "on-demand"}
}

# الأسعار

أسعار تنافسية تناسب جميع الاحتياجات — من المشاريع الفردية إلى الوكالات

تجريبي

$0 / مجاناً

5 فيديوهات مجانية للتجربة

5 فيديوهات 15 ثانية
صوت عربي خليجي
جودة 720p
دعم لهجة سعودية
أولوية المعالجة
Webhook إشعارات

احترافي

$0.50 / فيديو

باقات تبدأ من $50/شهر

فيديوهات بلا حدود
جميع اللهجات الخليجية
جودة 1080p
6 أصوات سعودية
أولوية المعالجة
Webhook إشعارات

وكالات

$0.30 / فيديو

التزام 500+ فيديو/شهر

سعر مخفض للكميات
White-label API
جميع اللهجات + MSA
جودة 4K
مدير حساب مخصص
SLA 99.9%

💡 تكلفة إنتاج الفيديو الواحد على أقل تقدير $0.71 — نبيعها بسعر يحقق هامش ربح 50-80%

# Webhooks

استلم إشعارات فورية عند اكتمال الفيديو:

json

// سجل webhook URL في لوحة التحكم
{
  "webhook_url": "https://your-domain.com/webhook/ugc",
  "events": ["job.completed", "job.failed"]
}

// الرد عند اكتمال الفيديو
{
  "event": "job.completed",
  "job_id": "job_a1b2c3d4e5",
  "video_url": "https://api.cortexlow.com/api/output/job_a1b2c3d4e5.mp4",
  "duration": 15,
  "cost": 0.50
}

# رموز الأخطاء

الرمز	المعنى	الإجراء
200	نجاح	الطلب تم بنجاح
400	طلب غير صالح	تحقق من المعاملات المرسلة
401	غير مصرح	تحقق من API Key
402	رصيد غير كافٍ	أضف رصيد لحسابك
429	تجاوز الحد	انتظر قبل إرسال طلب جديد
500	خطأ داخلي	أعد المحاولة بعد دقيقة

# SDKs ومكتبات

🐍

Python

pip install ugc-arabia

🟨

JavaScript / Node

npm install ugc-arabia

🔗

REST API

مباشر عبر HTTP — أي لغة برمجة

python

# مثال Python
import requests

response = requests.post(
    "https://api.cortexlow.com/api/generate",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "face_prompt": "Saudi woman, hijab, gold pins",
        "motion_prompt": "woman applying skincare, smiling",
        "script_text": "بنات هالمنتج غير حياتي",
        "dialect": "SAU",
        "voice": "noura"
    }
)

job = response.json()
print(f"Job ID: {job['job_id']}")

# حدود الاستخدام

المعامل	الحد	ملاحظة
الطلبات في الدقيقة	60	يزيد مع الباقات
الطلبات المتزامنة	3	قائمة انتظار تلقائية
حجم الملف المرفوع	20 MB	صور المنتجات
طول النص	500 حرف	حوالى 30 ثانية صوت
مدة الفيديو	5-15 ثانية	قابل للزيادة في باقات الوكالات

جاهز تبدأ؟ 🚀

تواصل معنا عبر تليجرام واحصل على API Key — أول 5 فيديوهات مجانية

💬 تليجرام 📧 البريد

ابدأ

واجهات البرمجة

متقدم

# Quick Start

1. احصل على API Key

2. أرسل طلب إنشاء

3. استلم الفيديو

✅ الرد — 200 OK

# المصادقة

# واجهات البرمجة

# إنشاء فيديو كامل

# إنشاء وجه فقط

# معاينة صوت

# حالة الطلب

✅ الرد — 200 OK

# المعرض

# النصوص الجاهزة

# حالة الخدمات

✅ الرد — 200 OK

# الأسعار

# Webhooks

# رموز الأخطاء

# SDKs ومكتبات

Python

JavaScript / Node

REST API

# حدود الاستخدام

جاهز تبدأ؟ 🚀