دمج واجهة برمجة تطبيقات Sora 2 Pro

معلمات الحمولة

• model: مطلوب. أحد: sora-2-text-to-video، sora-2-image-to-video، sora-2-text-to-video-stable، sora-2-image-to-video-stable، sora-2-pro-text-to-video، sora-2-pro-image-to-video، sora-2-pro-storyboard.
• prompt: شرطي. مطلوب لجميع النماذج باستثناء sora-2-pro-storyboard.
• imageData: شرطي. عنوان URL لبيانات Base64 مثل data:image/png;base64,... مطلوب لتحويل الصورة إلى فيديو إذا لم يكن هناك imageUrl.
• imageUrl: شرطي. عنوان URL للصورة العامة يُستخدم عندما لا يتم توفير imageData.
• aspectRatio: اختياري. portrait أو landscape. الافتراضي: landscape.
• nFrames: اختياري. 10 أو 15 أو 25 (لوحة القصة فقط). تختلف الافتراضيات حسب النموذج.
• size: اختياري. standard أو high. فقط لنماذج Pro نص/صورة.
• removeWatermark: اختياري. إزالة العلامة المائية للنماذج غير لوحة القصة. الافتراضي: true.
• isPublic: اختياري. ما إذا كان سيتم عرض الفيديو علنًا؛ الافتراضي هو true.
• shots: شرطي. مطلوب لـ sora-2-pro-storyboard. مصفوفة من '{ Scene, duration }'.

طلبات نموذجية

curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-text-to-video",
    "prompt": "A cinematic shot of a futuristic city at sunset.",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true,
    "isPublic": true
  }'

curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-image-to-video-stable",
    "prompt": "Turn this image into a dynamic 15s clip.",
    "imageData": "data:image/png;base64,iVBORw0KGgoAAA...",
    "aspectRatio": "portrait",
    "nFrames": "15"
  }'

curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-storyboard",
    "shots": [
      { "Scene": "Establishing shot of a city skyline at dusk", "duration": 5 },
      { "Scene": "Close-up of a runner splashing through puddles", "duration": 5 }
    ],
    "aspectRatio": "landscape",
    "nFrames": "10"
  }'

استجابة نموذجية

{
  "code": 0,
  "message": "ok",
  "data": {
    "taskId": "281e5b0*********************f39b9"
  }
}

معلمات الحمولة

• taskId: مطلوب. taskId المُرجع من الإنشاء.

طلب نموذجي

curl -X POST https://freesoragenerator.com/api/video-generations/check-result \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "281e5b0*********************f39b9"
  }'

استجابة نموذجية

{
  "code": 0,
  "message": "Success",
  "data": {
    "status": "running",
    "progress": 35,
    "result_url": "https://your-domain.com/storage/videos/xxx.mp4",
    "result_urls": [
      "https://your-domain.com/storage/videos/xxx.mp4"
    ],
    "failure_reason": "",
    "error_message": null
  }
}

طلب نموذجي

curl -X POST https://freesoragenerator.com/api/get-user-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

استجابة نموذجية

{
  "code": 0,
  "message": "ok",
  "data": {
    "left_credits": 120,
    "is_vip": false
  }
}