← الرئيسية
Viffly.app
خطة Businessعرض الأسعار →
توثيق واجهة برمجة التطبيقات

APIViffly

ادمج إنشاء مقاطع الريلز في سير عملك المؤتمت. تتيح واجهة Viffly REST إنشاء الفيديوهات وتتبّع المعالجة والوصول إلى السجل من أي تطبيق.

⚠️

الوصول إلى واجهة برمجة التطبيقات متاح فقط مع خطةBusiness.

عرض الأسعار →

المصادقة

يجب أن تتضمّن جميع طلبات واجهة برمجة التطبيقات رمز JWT الخاص بك في ترويسةAuthorization. احصل على رمزك عبر تسجيل الدخول إلى Viffly من ملفك الشخصي.

bash
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
POST/api/generateالإنشاء

يبدأ إنشاء مقطع ريلز فيديو. يقبل الصوت والصور ومعاملات النمط واللغة. يُرجِع job_id لتتبّع التقدّم.

المعاملات

audio
File | URL
مطلوب
ملف صوتي (mp3/wav) أو رابط عام
image_url_0..4
URL
مطلوب
رابط (روابط) الصور (الحد الأدنى 1، الحد الأقصى 5)
language
string
اختياري
رمز اللغة: fr, ar, en, es, de, pt (الافتراضي: تلقائي)
template
string
اختياري
default | news | minimal | highlight
title
string
اختياري
العنوان المعروض في المقدّمة
outro_text
string
اختياري
النص الرئيسي للخاتمة
outro_sub
string
اختياري
النص الفرعي للخاتمة
music_url
URL
اختياري
رابط ملف صوتي للموسيقى الخلفية

مثال

curl
curl -X POST https://viffly.app/api/generate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "audio=@narration.mp3" \
  -F "image_url_0=https://example.com/img1.jpg" \
  -F "template=default" \
  -F "language=fr"