جرّب OPTES
منصّة المطوّرين مرجع الواجهة

إنشاء فيديو

POST/v1/videos

يبدأ مهمة فيديو غير متزامنة ويرجع فوراً بمعرّفها. تابع حالتها، ثم نزّل الملف حين تكتمل.

النماذج: optes-motion-1

معاملات الطلب

application/json
  • modelstringمطلوب

    optes-motion-1.

  • promptstringمطلوب

    وصف المشهد والحركة والصوت.

  • secondsintegerاختياري

    من 4 إلى 10. الافتراضي 8.

  • sizestringاختياري

    1280x720 (الافتراضي) أو 720x1280 أو 1920x1080.

  • audiobooleanاختياري

    صوت مع الفيديو. الافتراضي true.

  • tierstringاختياري

    fast (720p بلا صوت) أو standard.

  • imagefile | stringاختياري

    صورة البداية، لتحريكها.

يرجع

كائن video. وقيمة status: queued ثم in_progress ثم completed أو failed. المهمة الفاشلة لا تُحسب، والملف يبقى متاحاً للتنزيل 24 ساعة.

حالة المهمة

GET/v1/videos/{id}

يرجع كائن video نفسه بحالته الحالية، ومعه error إن فشلت.

تنزيل الملف

GET/v1/videos/{id}/content

يرجع ملف MP4 بعد أن تصير الحالة completed.

curl https://api.optes3.com/v1/videos \  -H "Authorization: Bearer $OPTES_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "optes-motion-1",    "prompt": "لقطة جوية بطيئة لكورنيش عند الغروب، مع صوت الموج",    "seconds": 8,    "size": "1280x720"  }'
Response
{  "id": "video_7Kd2",  "object": "video",  "model": "optes-motion-1",  "status": "queued",  "seconds": 8,  "size": "1280x720",  "created_at": 1790640000}

الأسعار بالدولار الأمريكي، وهي أوّلية حتى الإطلاق. الواجهة البرمجية والتسجيل والمفاتيح تُفتح يوم الإطلاق.