API Gemini Omni 1.1 Flash

Référence complète de l’API pour les modèles de génération vidéo Google Gemini Omni 1.1 Flash.

Variantes du modèle

Cette API prend en charge quatre variantes du modèle :

Comparaison rapide

Endpoint commun

Toutes les variantes de Gemini Omni 1.1 Flash utilisent l’endpoint de tâche vidéo :

POST /api/v1/video/task

Gemini Omni 1.1 Flash Text to Video

Paramètres obligatoires

Exemple de requête

javascriptCopier
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.1-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: 8
  })
});

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

Gemini Omni 1.1 Flash Image to Video

Paramètres obligatoires

Paramètres facultatifs

Exemple de requête

javascriptCopier
{
  model_name: 'gemini-omni-1.1-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.1 Flash Video Edit

Paramètres obligatoires

Remarque : Video Edit ne prend en charge ni aspect_ratio ni duration. N’incluez aucun de ces paramètres dans la requête.

Exemple de requête

javascriptCopier
{
  model_name: 'gemini-omni-1.1-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.1 Flash Reference to Video

Les images et vidéos de référence sont facultatives et peuvent être utilisées séparément ou ensemble.

Paramètres obligatoires

Entrées de référence facultatives

Exemple de requête

javascriptCopier
{
  model_name: 'gemini-omni-1.1-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: 8,
  images: ['https://example.com/boat-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4']
}

Format de la réponse

Réponse initiale

Tous les modèles renvoient un task_id permettant d’interroger leur état :

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

Réponse d’interrogation

Interrogez GET /api/v1/video/{taskId} pour vérifier l’état :

jsonCopier
{
  "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": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Valeurs d’état

• submitted : Tâche acceptée et en attente de traitement
• processing : Génération vidéo en cours
• succeed : Génération vidéo terminée
• failed : Échec de la génération vidéo

Bonnes pratiques

1. Précision du prompt : Décrivez clairement les sujets, les actions, les mouvements de caméra, l’éclairage et la progression de la scène.
2. Paramètres obligatoires : Indiquez toujours une résolution prise en charge et, sauf pour Video Edit, un format d’image et une durée pris en charge.
3. Images d’entrée : Utilisez des URL stables et accessibles publiquement pour les images de départ, de fin et de référence.
4. Entrée de Video Edit : Vérifiez que la vidéo source dure entre 3 et 10 secondes avant de l’envoyer.
5. Limites des références : N’envoyez pas plus de 10 images et 3 vidéos, et limitez chaque vidéo de référence à 3 secondes maximum.