# Gemini Omni 1.2 Flash API

Referencia completa de la API de los modelos de generación de vídeo Google Gemini Omni 1.2 Flash.

## Variantes del modelo

Esta API admite cuatro variantes del modelo:

| Modelo | ID | Descripción |
|-------|-----|-------------|
| **Gemini Omni 1.2 Flash Text to Video** | `gemini-omni-1.2-flash-text-to-video` | Generar vídeos a partir de descripciones de texto |
| **Gemini Omni 1.2 Flash Image to Video** | `gemini-omni-1.2-flash-image-to-video` | Animar una imagen inicial obligatoria con la opción de usar una imagen final como guía |
| **Gemini Omni 1.2 Flash Video Edit** | `gemini-omni-1.2-flash-video-edit` | Aplicar cambios a un vídeo existente siguiendo instrucciones de texto |
| **Gemini Omni 1.2 Flash Reference to Video** | `gemini-omni-1.2-flash-reference-to-video` | Generar vídeos a partir de imágenes de referencia, vídeos de referencia o ambos |

## Comparación rápida

| Característica | Texto a vídeo | Imagen a vídeo | Edición de vídeo | Vídeo a partir de referencias |
|---------|---------------|----------------|------------|--------------------|
| Entrada principal | Descripción de texto | Imagen inicial + descripción de texto | Vídeo de origen + instrucciones de texto | Descripción de texto + al menos una imagen o un vídeo de referencia |
| Duración | De 3 a 15 segundos | De 3 a 15 segundos (de 3 a 10 con imagen final) | El vídeo de origen no debe superar los 10 segundos | De 3 a 15 segundos |
| Resoluciones disponibles | 360p, 720p, 1080p, 4k | 360p, 720p, 1080p, 4k | 360p, 720p, 1080p, 4k | 360p, 720p, 1080p, 4k |
| Relaciones de aspecto | 16:9, 9:16 | 16:9, 9:16 | No se admite | 16:9, 9:16 |
| Entradas opcionales | Ninguna | Imagen final | Ninguna | Hasta 10 imágenes y 3 vídeos, con al menos una referencia obligatoria |

## Endpoint común

Todas las variantes de Gemini Omni 1.2 Flash utilizan el endpoint de tareas de vídeo:

```
POST /api/v1/video/task
```

## Gemini Omni 1.2 Flash Text to Video

### Parámetros obligatorios

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `model_name` | string | Valor obligatorio: `"gemini-omni-1.2-flash-text-to-video"` |
| `prompt` | string | Descripción de texto del vídeo que se quiere generar |
| `aspect_ratio` | string | Relación de aspecto de salida: `"16:9"` o `"9:16"` |
| `resolution` | string | Resolución de salida: `"360p"`, `"720p"`, `"1080p"` o `"4k"` |
| `duration` | integer | Duración del vídeo generado, de 3 a 15 segundos |

### Ejemplo de solicitud

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

### Parámetros obligatorios

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `model_name` | string | Valor obligatorio: `"gemini-omni-1.2-flash-image-to-video"` |
| `prompt` | string | Descripción de texto del movimiento deseado y de la evolución de la escena |
| `image_url` | string | URL de la imagen inicial obligatoria |
| `aspect_ratio` | string | Relación de aspecto de salida: `"16:9"` o `"9:16"` |
| `resolution` | string | Resolución de salida: `"360p"`, `"720p"`, `"1080p"` o `"4k"` |
| `duration` | integer | Duración de salida en segundos: de 3 a 15 sin imagen final o de 3 a 10 si se proporciona `image_end_url` |

### Parámetros opcionales

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `image_end_url` | string | URL de una imagen final opcional. Si se proporciona, `duration` debe estar entre 3 y 10 segundos |

### Ejemplo de solicitud

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

### Parámetros obligatorios

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `model_name` | string | Valor obligatorio: `"gemini-omni-1.2-flash-video-edit"` |
| `prompt` | string | Instrucciones de texto que describen el cambio que se quiere aplicar |
| `video_url` | string | URL del vídeo de origen. Su duración no debe superar los 10 segundos |
| `resolution` | string | Resolución de salida: `"360p"`, `"720p"`, `"1080p"` o `"4k"` |

**Nota:** Video Edit no admite `aspect_ratio` ni `duration`. Omita ambos parámetros en la solicitud.

### Ejemplo de solicitud

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

Las imágenes y los vídeos de referencia se pueden usar por separado o en conjunto. Debe proporcionar al menos una imagen o un vídeo de referencia en `images` o `videos`.

### Parámetros obligatorios

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `model_name` | string | Valor obligatorio: `"gemini-omni-1.2-flash-reference-to-video"` |
| `prompt` | string | Descripción de texto del vídeo que se quiere generar |
| `aspect_ratio` | string | Relación de aspecto de salida: `"16:9"` o `"9:16"` |
| `resolution` | string | Resolución de salida: `"360p"`, `"720p"`, `"1080p"` o `"4k"` |
| `duration` | integer | Duración del vídeo generado, de 3 a 15 segundos |

### Referencias opcionales

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `images` | string[] | Hasta 10 URL de imágenes de referencia. Opcional si se proporcionan vídeos de referencia |
| `videos` | string[] | Hasta 3 URL de vídeos de referencia. Cada vídeo debe durar como máximo 3 segundos. Opcional si se proporcionan imágenes de referencia |

### Ejemplo de solicitud

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

## Formato de respuesta

### Respuesta inicial

Todos los modelos devuelven un `task_id` para consultar periódicamente el estado de la tarea:

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

### Respuesta a la consulta de estado

Consulte periódicamente `GET /api/v1/video/{taskId}` para comprobar el estado:

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

### Valores de estado

- `submitted`: Tarea aceptada y en espera de procesamiento
- `processing`: Generación del vídeo en curso
- `succeed`: Generación del vídeo completada
- `failed`: Error en la generación del vídeo

## Prácticas recomendadas

1. **Redacción de la descripción**: describa con claridad los sujetos, las acciones, el movimiento de cámara, la iluminación y la evolución de la escena.
2. **Ajustes obligatorios**: indique siempre una resolución admitida y, salvo para Video Edit, una relación de aspecto y una duración admitidas.
3. **Imágenes de entrada**: utilice URL estables y de acceso público para las imágenes iniciales, finales y de referencia. Si proporciona una imagen final, mantenga `duration` entre 3 y 10 segundos.
4. **Entrada de Video Edit**: antes de enviar el vídeo de origen, compruebe que no supere los 10 segundos.
5. **Límites de las referencias**: proporcione al menos una imagen o un vídeo de referencia. Envíe como máximo 10 imágenes y 3 vídeos. Cada vídeo de referencia debe durar como máximo 3 segundos.