Gemini Omni 1.2 Flash API

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

Variantes du modèle

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

Comparaison rapide

Point de terminaison commun

Toutes les variantes de Gemini Omni 1.2 Flash utilisent le point de terminaison des tâches vidéo :

POST /api/v1/video/task

Gemini Omni 1.2 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.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

Paramètres obligatoires

Paramètres facultatifs

Exemple de requête

javascriptCopier
{
  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

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.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

Les images et les vidéos de référence peuvent être utilisées séparément ou ensemble. Vous devez fournir au moins une image ou une vidéo de référence dans images ou videos.

Paramètres obligatoires

Références facultatives

Exemple de requête

javascriptCopier
{
  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']
}

Format de réponse

Réponse initiale

Tous les modèles renvoient un task_id permettant d’interroger l’état de la tâche :

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 à une interrogation de l’état

Interrogez régulièrement GET /api/v1/video/{taskId} pour vérifier l’état de la tâche :

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

Valeurs de statut

• submitted: Tâche acceptée, 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. Rédaction du prompt : décrivez clairement les sujets, les actions, les mouvements de caméra, l’éclairage et l’évolution de la scène.
2. Réglages obligatoires : indiquez toujours une résolution prise en charge et, sauf pour Video Edit, un rapport largeur/hauteur et une durée pris en charge.
3. Images d’entrée : utilisez des URL stables et accessibles au public pour les images initiales, finales et de référence. Si vous fournissez une image finale, limitez duration à une valeur comprise entre 3 et 10 secondes.
4. Vidéo à modifier : avant d’envoyer la vidéo source, vérifiez que sa durée ne dépasse pas 10 secondes.
5. Limites des références : fournissez au moins une image ou une vidéo de référence. Envoyez au maximum 10 images et 3 vidéos, sans dépasser 3 secondes par vidéo de référence.