واجهة برمجة تطبيقات Gemini Omni 1.2 Flash

المرجع الكامل لواجهة برمجة التطبيقات الخاصة بنماذج Google Gemini Omni 1.2 Flash لتوليد الفيديو.

إصدارات النموذج

تدعم هذه الواجهة أربعة إصدارات من النموذج:

مقارنة سريعة

نقطة النهاية المشتركة

تستخدم جميع إصدارات Gemini Omni 1.2 Flash نقطة النهاية المخصصة لمهام الفيديو:

POST /api/v1/video/task

Gemini Omni 1.2 Flash Text to Video

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

مثال على الطلب

javascriptنسخ
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'gemini-omni-1.2-flash-text-to-video',
    prompt: 'A cinematic tracking shot follows a sailboat crossing a glowing ocean at sunset',
    aspect_ratio: '16:9',
    resolution: '1080p',
    duration: 12
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Gemini Omni 1.2 Flash Image to Video

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

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

مثال على الطلب

javascriptنسخ
{
  model_name: 'gemini-omni-1.2-flash-image-to-video',
  prompt: 'The girl walks toward the camera while the city lights shimmer behind her',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  aspect_ratio: '9:16',
  resolution: '1080p',
  duration: 8
}

Gemini Omni 1.2 Flash Video Edit

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

ملاحظة: لا يدعم نموذج Video Edit المعاملين aspect_ratio وduration. لا تُدرج أيًا منهما في الطلب.

مثال على الطلب

javascriptنسخ
{
  model_name: 'gemini-omni-1.2-flash-video-edit',
  prompt: 'A small ball rolls into the scene and captures the attention of the cat',
  video_url: 'https://example.com/source-video.mp4',
  resolution: '1080p'
}

Gemini Omni 1.2 Flash Reference to Video

يمكن استخدام الصور ومقاطع الفيديو المرجعية كلٌّ على حدة أو معًا. يجب تقديم صورة مرجعية واحدة أو فيديو مرجعي واحد على الأقل في images أو videos.

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

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

مثال على الطلب

javascriptنسخ
{
  model_name: 'gemini-omni-1.2-flash-reference-to-video',
  prompt: 'Use the references to create a cinematic shot of a small boat approaching from the distance',
  aspect_ratio: '16:9',
  resolution: '1080p',
  duration: 12,
  images: ['https://example.com/boat-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4']
}

تنسيق الاستجابة

الاستجابة الأولية

تُرجع جميع النماذج task_id لاستخدامه في الاستعلام الدوري عن حالة المهمة:

jsonنسخ
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

استجابة الاستعلام الدوري

أرسل طلب GET /api/v1/video/{taskId} دوريًا للتحقق من الحالة:

jsonنسخ
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

قيم الحالة

• submitted: قُبلت المهمة وهي تنتظر المعالجة
• processing: جارٍ توليد الفيديو
• succeed: اكتمل توليد الفيديو
• failed: تعذّر توليد الفيديو

أفضل الممارسات

1. صياغة الوصف النصي: صِف بوضوح عناصر المشهد والأفعال وحركة الكاميرا والإضاءة وتطور المشهد.
2. الإعدادات المطلوبة: حدّد دائمًا دقة مدعومة. ولجميع الإصدارات باستثناء Video Edit، حدّد أيضًا نسبة عرض إلى ارتفاع ومدة مدعومتين.
3. الصور المدخلة: استخدم عناوين URL ثابتة ومتاحة للعامة لصور البداية والنهاية والصور المرجعية. عند تقديم صورة للإطار النهائي، اضبط duration على قيمة بين 3 و10 ثوانٍ.
4. الفيديو المراد تعديله: تحقّق قبل الإرسال من أن مدة الفيديو الأصلي لا تتجاوز 10 ثوانٍ.
5. حدود المراجع: قدّم صورة مرجعية واحدة أو فيديو مرجعيًا واحدًا على الأقل. الحد الأقصى هو 10 صور و3 مقاطع فيديو، ويجب ألا تتجاوز مدة أي مقطع مرجعي 3 ثوانٍ.