RESTful API + Webhooks

وصف الفيديو API للمطورين

ادمج إنشاء البيانات الوصفية للفيديو بالذكاء الاصطناعي داخل منصتك. أرسل روابط الفيديو، بما في ذلك بيانات HLS VOD، عبر API واستقبل العناوين والأوصاف والوسوم عبر webhooks. حلّل الإطارات المرئية والمحتوى الصوتي معًا. بيئة اختبار مجانية للتجربة.

الخطوة 1
أرسل رابط الفيديو عبر POST
الخطوة 2
معالجة غير متزامنة
الخطوة 3
استقبل الـ webhook
POST /v1/video-descriptions
sample-video.mp4
00:02:34
vision_audio frames:20
Request
# أنشئ مهمة: vision أو vision_audio أو audio
curl -X POST https://api.descrideo.com/v1/video-descriptions
-H "X-API-Key: YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"source":{"type":"direct_url"}}'
202 Accepted
{
  "job_id": "01HXYZ123ABC",
  "status": "queued",
  "delivery": "webhook"
}
01
الخطوة 1

أرسل رابط الفيديو عبر POST

أرسل طلب POST يتضمن رابط الفيديو. الروابط المباشرة للوسائط أو بيانات HLS VOD أو الوصول الموثق مدعومة.

02
الخطوة 2

معالجة غير متزامنة

تستخرج الواجهة الإطارات والصوت وتجري تحليل الذكاء الاصطناعي. تتبع الحالة عبر معرّف المهمة أو انتظر الـ webhook.

03
الخطوة 3

استقبل الـ webhook

احصل على JSON يتضمن العنوان والوصف والوسوم عبر webhook موقّع بـ HMAC.

Descrideo مقابل الأدوات العامة

إذا كان هدفك هو توليد بيانات وصفية موثوقة للفيديو، فغالبًا ما يتفوق المسار المتخصص على تجميع واجهات API متعددة الوسائط للأغراض العامة.

Descrideo

موصى به للفرق التي تضع البيانات الوصفية أولًا
الأفضل لـ
واجهات وصف فيديو غير متزامنة، وتدفقات webhook، وبوابات للمطورين
نقطة القوة
مبني خصيصًا للعناوين والأوصاف والوسوم والوصول الخاص للفيديو والأتمتة المعتمدة على webhooks.
المقايضات
نطاقه أضيق من المنصات السحابية الضخمة، لكنه أسرع في تحقيق القيمة لهذا الاستخدام تحديدًا.

Google Video AI

الأفضل لـ
الأنظمة السحابية الكبيرة وخطوط المعالجة المخصصة لذكاء الوسائط
نقطة القوة
تكاملات سحابية عميقة وأدوات تعلم آلي واسعة.
المقايضات
يتطلب تركيبًا إضافيًا إذا كنت تحتاج فقط إلى توليد بيانات وصفية جاهزة للإنتاج مع webhooks.

Cloudinary

الأفضل لـ
إدارة الوسائط والتحويلات وخطوط التسليم
نقطة القوة
قوي جدًا في تسليم الأصول وتحسينها.
المقايضات
توليد بيانات SEO للفيديو يكون عادة ميزة ضمن مجموعة أكبر، وليس الواجهة الأساسية للمنتج.

AssemblyAI

الأفضل لـ
المنتجات المعتمدة على الكلام وتدفقات transcription-first
نقطة القوة
قوي في الصوت والتفريغ النصي.
المقايضات
قد تحتاج إلى منطق إضافي لتحليل الإطارات والمخرجات المجمعة وتنسيق البيانات الخاص بالفيديو.

لماذا يختار المطورون واجهة Descrideo API

واجهة وصف فيديو بمستوى المؤسسات مبنية للتوسع والأمان وتجربة المطور

اختبار Sandbox مجاني

اختبر تكاملك مع عمليات تسليم webhook حقيقية دون الحاجة إلى معالجة فيديو فعلية. تشمل حصة يومية مجانية.

بيئة تجريبية
$ curl https://api.descrideo.com/v1/video-descriptions
-H "Authorization: Bearer nxt_test_key"
# webhook delivery without full production wiring

تسليم غير متزامن عبر Webhook

واجهة API غير حاجزة مع webhooks موقعة بـ HMAC وإعادة محاولات تلقائية بتراجع أسي.

واجهة البوابة قيد الانتظار
Webhook موقّع
تطبيقك تمت المعالجة

وصول مرن إلى الفيديو

روابط وسائط مباشرة أو بيانات HLS VOD أو وصول موثق أو نمط Source Provider. حافظ على خصوصية فيديوهاتك.

direct_url
authenticated access
source_provider

فوترة مرنة

رصيد توكنات مسبق الدفع أو وضع الدفع اللاحق. ادفع فقط مقابل المعالجة الناجحة دون رسوم مخفية.

دفع مسبق
رصيد التوكنات
دفع لاحق
الدفع عند النجاح

تفريغ صوتي

ثلاثة أوضاع للإنشاء: الرؤية فقط أو الرؤية + الصوت أو الصوت فقط. استفد من المحتوى المنطوق لأوصاف أغنى.

أمان على مستوى المؤسسات

حماية SSRF وتشفير للبيانات أثناء السكون وتواقيع HMAC-SHA256 وسجل تدقيق.

التوقيع
HMAC-SHA256
التسجيل
سجلات التدقيق
التخزين
وصول خاص

واجهة REST API بسيطة

ابدأ ببضعة أسطر فقط من الشيفرة

إنشاء مهمة وصف فيديو
# أنشئ مهمة: vision أو vision_audio أو audio
curl -X POST https://api.descrideo.com/v1/video-descriptions \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {
      "type": "direct_url",
      "url": "https://example.com/video.mp4"
    },
    "frames": 20,
    "generation_mode": "vision_audio",
    "webhook": {"url": "https://your-app.com/webhooks/video"}
  }'
# الاستجابة: 202 Accepted
{ "job_id": "01HXYZ123ABC", "status": "queued" }

وصفات تكامل لِـ فرق حقيقية

استخدم الواجهة نفسها من خدمات backend أو الطوابير أو تدفقات CMS أو أدوات الأتمتة منخفضة الكود.

Python

Python

شغّل المهام من خلفيات FastAPI أو Django أو Flask ثم أرسل النتائج إلى نظام CMS لديك.

import requests

payload = {
    'source': {'type': 'direct_url', 'url': 'https://example.com/video.mp4'},
    'frames': 20,
    'generation_mode': 'vision_audio',
    'webhook': {'url': 'https://app.example.com/webhooks/descriptions'},
}

response = requests.post(
    'https://api.descrideo.com/v1/video-descriptions',
    headers={'Authorization': 'Bearer nxt_live_key'},
    json=payload,
    timeout=30,
)

Node.js

Node.js

اربط إنشاء البيانات الوصفية بأحداث اكتمال الرفع أو العمال الخلفيين في منتجك.

const response = await fetch('https://api.descrideo.com/v1/video-descriptions', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer nxt_live_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    source: { type: 'direct_url', url: 'https://example.com/demo.mp4' },
    frames: 30,
    generation_mode: 'vision',
    webhook: { url: 'https://app.example.com/webhooks/descriptions' },
  }),
})

PHP

PHP

أرسل المهام من Laravel actions أو queue jobs أو أدوات الإدارة واحتفِظ بمعرّف المهمة للمطابقة لاحقًا.

use Illuminate\Support\Facades\Http;

$response = Http::withToken('nxt_live_key')
    ->post('https://api.descrideo.com/v1/video-descriptions', [
        'source' => ['type' => 'source_provider', 'provider' => ['asset_id' => 'video_123']],
        'frames' => 20,
        'generation_mode' => 'vision_audio',
        'webhook' => ['url' => 'https://app.example.com/webhooks/descriptions'],
    ]);

No-code

No-code

استخدم Make أو Zapier أو n8n أو مشغّلًا داخليًا لربط الرفع وwebhooks والنشر.

1. يتم رفع فيديو جديد إلى التخزين
2. أرسل طلب POST لإنشاء المهمة إلى Descrideo
3. انتظر callback الـ webhook الموقّع
4. استخرج العنوان والوصف والوسوم
5. ادفع البيانات الوصفية إلى CMS أو الكتالوج أو فهرس البحث

نتائج أولية من تدفقات عمل حقيقية

تمثل هذه الأمثلة تطبيقات داخلية أو تجريبية وتوضح نوع المكاسب في الكفاءة وقابلية الاكتشاف التي يمكن للفرق توقعها.

حالة تجريبية 01

إدخال محتوى UGC إلى marketplace

التحدي

احتاجت منصة محتوى إلى أن يصل كل فيديو مرفوع بعناوين ووسوم قابلة للبحث قبل المراجعة التحريرية.

التنفيذ

تم تشغيل Descrideo عند اكتمال الرفع وأعاد البيانات الوصفية بشكل غير متزامن إلى قائمة الانتظار الخاصة بالمراجعة.

  • ارتفعت تغطية البيانات الوصفية من 18٪ إلى 92٪ للفيديوهات الجديدة.
  • انخفض متوسط وقت الفهرسة اليدوية من نحو يومي عمل إلى أقل من 30 دقيقة.
  • بدأ المحررون المراجعة بعناوين وأوصاف ووسوم متعددة اللغات ومعبأة مسبقًا.
تدفق إمكانية الوصول 02

تراكم أعمال إمكانية الوصول في مكتبة تدريب

التحدي

احتاجت بوابة تعلم داخلية إلى مسودات وصف لمئات التسجيلات التدريبية المؤرشفة.

التنفيذ

ولّد وضع الرؤية + الصوت ملخصات أولية وملاحظات منظمة لفرق مراجعة إمكانية الوصول.

  • خفض المراجعون وقت إعداد المسودة الأولى بنحو 60٪.
  • استخدمت الفرق payload webhook واحدًا لملء ملخصات LMS وقوائم التحقق الخاصة بإمكانية الوصول.
  • حصل مالكو المحتوى على خط أساس موحّد للبيانات الوصفية في التسجيلات القديمة.
أتمتة الكتالوج 03

SEO لفيديوهات المنتجات على نطاق واسع

التحدي

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

التنفيذ

أنشأ Descrideo نصوصًا جاهزة لـ SEO وكانت فرق التسويق التجاري تراجعها قبل النشر على صفحات المنتجات.

  • خفضت فرق النشر وقت كتابة النصوص من ساعات إلى دقائق لكل دفعة إطلاق.
  • حصلت فرق البحث على وسوم منظمة وحقول جاهزة لـ VideoObject لصفحات المنتجات.
  • حافظت فرق التسويق التجاري على نبرة العلامة التجارية عبر تعليمات مخصصة لكل دفعة.
POST /v1/video-descriptions

ابدأ البناء باستخدام Descrideo API

احصل على مفتاح API وابدأ الاختبار عبر بيئة Sandbox المجانية. لا حاجة إلى بطاقة ائتمان.