صورة إلى فيديو

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

الطلب

أنشئ فيديو عن طريق إرسال صورتك وموجهك إلى نقطة النهاية الشاملة /v1/run:

أمثلة الطلبات

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "image-to-video",
           "inputs": {
             "imageUrl": "https://example.com/product.jpg",
             "prompt": "Camera pans slowly around the model as she walks forward",
             "duration": 6,
             "aspectRatio": "9:16"
           }
         }'

الاستجابة

نظرًا لأن إنشاء الفيديو يستغرق عدة دقائق، فإن نقطة النهاية /v1/run تُرجع حالة 200 OK فورًا مع id لوظيفة غير متزامنة. يجب عليك استقصاء واجهة برمجة تطبيقات الحالة باستخدام GET /v1/status/{id} لاسترداد عنوان URL النهائي لملف MP4. بدلاً من ذلك، يمكنك تكوين webhooks لتلقي الإشعارات تلقائيًا. يرجى ملاحظة أن مرسل webhook الخاص بنا يفرض مهلة صارمة تبلغ 15 ثانية. يجب أن يؤكد خادمك webhook برمز حالة 2xx في غضون 15 ثانية، وإلا سنعتبره فاشلاً ونعيد المحاولة لاحقًا.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

معلمات الطلب

المعلمات المطلوبة

المعلمات الاختيارية

أخطاء وقت التشغيل

تستخدم أخطاء وقت التشغيل لهذه الميزة المجموعة المشتركة الموثقة في معالجة الأخطاء. إذا حدث خطأ أثناء المعالجة، فسيتم تحديث status إلى "error" وسيحتوي حقل error على سبب الفشل المحدد.

تكلفة الاعتمادات

بالنسبة لطلبات واجهة برمجة تطبيقات المطورين، تعتمد التكلفة بالكامل على duration الفيديو المطلوب.

الصيغة: التكلفة = اعتمادات المدة