# 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 :

| Modèle | Identifiant | Description |
|-------|-----|-------------|
| **Gemini Omni 1.2 Flash Text to Video** | `gemini-omni-1.2-flash-text-to-video` | Générer des vidéos à partir de descriptions textuelles |
| **Gemini Omni 1.2 Flash Image to Video** | `gemini-omni-1.2-flash-image-to-video` | Animer une image initiale obligatoire, avec la possibilité de guider le résultat par une image finale |
| **Gemini Omni 1.2 Flash Video Edit** | `gemini-omni-1.2-flash-video-edit` | Modifier une vidéo existante en suivant des instructions textuelles |
| **Gemini Omni 1.2 Flash Reference to Video** | `gemini-omni-1.2-flash-reference-to-video` | Générer des vidéos à partir d’images de référence, de vidéos de référence ou des deux |

## Comparaison rapide

| Caractéristique | Du texte à la vidéo | De l’image à la vidéo | Montage vidéo | Vidéo à partir de références |
|---------|---------------|----------------|------------|--------------------|
| Entrée principale | Description textuelle | Image initiale + description textuelle | Vidéo source + instructions textuelles | Description textuelle + au moins une image ou vidéo de référence |
| Durée | 3 à 15 secondes | 3 à 15 secondes (3 à 10 avec une image finale) | La vidéo source ne doit pas dépasser 10 secondes | 3 à 15 secondes |
| Résolutions disponibles | 360p, 720p, 1080p, 4k | 360p, 720p, 1080p, 4k | 360p, 720p, 1080p, 4k | 360p, 720p, 1080p, 4k |
| Rapports largeur/hauteur | 16:9, 9:16 | 16:9, 9:16 | Non pris en charge | 16:9, 9:16 |
| Entrées facultatives | Aucune | Image finale | Aucune | Jusqu’à 10 images et 3 vidéos, avec au moins une référence obligatoire |

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

| Paramètre | Type | Description |
|-----------|------|-------------|
| `model_name` | string | Valeur requise : `"gemini-omni-1.2-flash-text-to-video"` |
| `prompt` | string | Description textuelle de la vidéo à générer |
| `aspect_ratio` | string | Rapport largeur/hauteur de sortie : `"16:9"` ou `"9:16"` |
| `resolution` | string | Résolution de sortie : `"360p"`, `"720p"`, `"1080p"` ou `"4k"` |
| `duration` | integer | Durée de la vidéo générée, de 3 à 15 secondes |

### Exemple de requête

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

### Paramètres obligatoires

| Paramètre | Type | Description |
|-----------|------|-------------|
| `model_name` | string | Valeur requise : `"gemini-omni-1.2-flash-image-to-video"` |
| `prompt` | string | Description textuelle du mouvement souhaité et de l’évolution de la scène |
| `image_url` | string | URL de l’image initiale obligatoire |
| `aspect_ratio` | string | Rapport largeur/hauteur de sortie : `"16:9"` ou `"9:16"` |
| `resolution` | string | Résolution de sortie : `"360p"`, `"720p"`, `"1080p"` ou `"4k"` |
| `duration` | integer | Durée de sortie en secondes : de 3 à 15 sans image finale, ou de 3 à 10 si `image_end_url` est fourni |

### Paramètres facultatifs

| Paramètre | Type | Description |
|-----------|------|-------------|
| `image_end_url` | string | URL d’une image finale facultative. Si elle est fournie, `duration` doit être compris entre 3 et 10 secondes |

### Exemple de requête

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

### Paramètres obligatoires

| Paramètre | Type | Description |
|-----------|------|-------------|
| `model_name` | string | Valeur requise : `"gemini-omni-1.2-flash-video-edit"` |
| `prompt` | string | Instructions textuelles décrivant la modification à apporter |
| `video_url` | string | URL de la vidéo source. Sa durée ne doit pas dépasser 10 secondes |
| `resolution` | string | Résolution de sortie : `"360p"`, `"720p"`, `"1080p"` ou `"4k"` |

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

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

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

| Paramètre | Type | Description |
|-----------|------|-------------|
| `model_name` | string | Valeur requise : `"gemini-omni-1.2-flash-reference-to-video"` |
| `prompt` | string | Description textuelle de la vidéo à générer |
| `aspect_ratio` | string | Rapport largeur/hauteur de sortie : `"16:9"` ou `"9:16"` |
| `resolution` | string | Résolution de sortie : `"360p"`, `"720p"`, `"1080p"` ou `"4k"` |
| `duration` | integer | Durée de la vidéo générée, de 3 à 15 secondes |

### Références facultatives

| Paramètre | Type | Description |
|-----------|------|-------------|
| `images` | string[] | Jusqu’à 10 URL d’images de référence. Facultatif si des vidéos de référence sont fournies |
| `videos` | string[] | Jusqu’à 3 URL de vidéos de référence. Chaque vidéo doit durer au plus 3 secondes. Facultatif si des images de référence sont fournies |

### Exemple de requête

```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']
}
```

## Format de réponse

### Réponse initiale

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

```json
{
  "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 :

```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"
        }
      ]
    }
  }
}
```

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