🚀 توثيق Ommini API

يبدأ إنشاء فيديو بالذكاء الاصطناعي (fal.ai Kling v1.6). يجري الإنشاء في الخلفية ويستغرق عادةً من 2 إلى 4 دقائق.

يُحتسب كل فيديو من الحصة الشهرية لخطتك. عند نفاد الحصة تُستخدم 5 أرصدة. إذا لم تكفِ الحصة ولا الأرصدة تكون الاستجابة 429.

متن الطلب

مثال cURL

curl -X POST https://ommini.com/api/v1/video/create \
  -H "X-API-Key: omn_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A calm turquoise sea at sunrise, gentle waves, cinematic drone shot",
    "baslik": "Sunrise Sea",
    "sure": "5",
    "oran": "9:16"
  }'

الاستجابة

{
  "success": true,
  "video_id": 197,
  "durum": "isleniyor",
  "mesaj": "..."
}

يعرض حالة الفيديو وتفاصيله. أثناء المعالجة تُحدَّث الحالة مع كل طلب.

قيم durum: isleniyor (قيد المعالجة) وhazir (جاهز، ويحتوي video_url على الرابط) وhata (فشل الإنشاء).

استعلم كل 15-30 ثانية حتى يصبح الفيديو جاهزاً.

مثال cURL

curl https://ommini.com/api/v1/video/197 \
  -H "X-API-Key: omn_your_key"

الاستجابة

{
  "id": 197,
  "baslik": "Sunrise Sea",
  "prompt": "A calm turquoise sea at sunrise, gentle waves, cinematic drone shot",
  "stil": "cinematic",
  "sure": "5",
  "oran": "9:16",
  "durum": "hazir",
  "video_url": "https://v3b.fal.media/files/.../output.mp4",
  "thumbnail_url": null,
  "tarih": "2026-10-09T20:02:11"
}

يعرض فيديوهاتك من الأحدث إلى الأقدم.

معاملات الاستعلام

الحقل total هو عدد السجلات في هذه الاستجابة. يتضمن كل فيديو id وbaslik وdurum وvideo_url وtarih.

مثال cURL

curl "https://ommini.com/api/v1/videos?limit=10&offset=0" \
  -H "X-API-Key: omn_your_key"

ينشئ سجل منشور جديد.

متن الطلب

مثال cURL

curl -X POST https://ommini.com/api/v1/post/create \
  -H "X-API-Key: omn_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "baslik": "New Product Launch",
    "icerik": "Excited to announce our new product!",
    "platform": "linkedin",
    "durum": "taslak"
  }'

الاستجابة

{
  "success": true,
  "post_id": 42,
  "mesaj": "..."
}

يعرض منشوراتك من الأحدث إلى الأقدم.

معاملات الاستعلام

يتضمن كل منشور id وbaslik وicerik وplatform وdurum وtarih وplanlanan_tarih.

مثال cURL

curl "https://ommini.com/api/v1/posts?platform=linkedin&durum=taslak" \
  -H "X-API-Key: omn_your_key"

يحفظ المنشور مع تاريخه المجدول بالحالة planli (مجدول).

متن الطلب

مثال cURL

curl -X POST https://ommini.com/api/v1/post/schedule \
  -H "X-API-Key: omn_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "baslik": "Weekend Sale",
    "icerik": "Do not miss our weekend sale!",
    "platform": "instagram",
    "planlanan_tarih": "2026-11-15T10:00:00"
  }'

الاستجابة

{
  "success": true,
  "post_id": 43,
  "planlanan_tarih": "2026-11-15T10:00:00",
  "mesaj": "..."
}

يحفظ مستنداً جديداً في صفحة المستندات لديك.

متن الطلب

مثال cURL

curl -X POST https://ommini.com/api/v1/document/create \
  -H "X-API-Key: omn_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "baslik": "Q4 Content Plan",
    "icerik": "Week 1: product teaser...",
    "tur": "Rapor"
  }'

الاستجابة

{
  "success": true,
  "document_id": 15,
  "mesaj": "..."
}

يعرض مستنداتك من الأحدث إلى الأقدم، ويتضمن كل مستند أول 200 حرف من محتواه.

معاملات الاستعلام

يتحقق من أن واجهة API تعمل. لا يتطلب مفتاح API.

مثال cURL

curl https://ommini.com/api/v1/health

الاستجابة

{
  "status": "ok",
  "version": "1.0.0",
  "service": "Ommini API"
}