# API do Gemini Omni 1.2 Flash

Referência completa da API dos modelos de geração de vídeo Google Gemini Omni 1.2 Flash.

## Variantes do modelo

Esta API oferece suporte a quatro variantes do modelo:

| Modelo | ID | Descrição |
|-------|-----|-------------|
| **Gemini Omni 1.2 Flash Text to Video** | `gemini-omni-1.2-flash-text-to-video` | Gera vídeos a partir de instruções de texto |
| **Gemini Omni 1.2 Flash Image to Video** | `gemini-omni-1.2-flash-image-to-video` | Anima uma imagem inicial obrigatória e permite usar um quadro final para orientar o resultado |
| **Gemini Omni 1.2 Flash Video Edit** | `gemini-omni-1.2-flash-video-edit` | Aplica alterações a um vídeo existente conforme as instruções de texto |
| **Gemini Omni 1.2 Flash Reference to Video** | `gemini-omni-1.2-flash-reference-to-video` | Gera vídeos com base em imagens de referência, vídeos de referência ou ambos |

## Comparação rápida

| Recurso | Texto para vídeo | Imagem para vídeo | Edição de vídeo | Referências para vídeo |
|---------|---------------|----------------|------------|--------------------|
| Entrada principal | Instrução de texto | Imagem inicial e instrução de texto | Vídeo de origem e instrução de texto | Instrução de texto e pelo menos uma imagem ou um vídeo de referência |
| Duração | 3 a 15 segundos | 3 a 15 segundos, ou 3 a 10 com quadro final | O vídeo de origem deve ter no máximo 10 segundos | 3 a 15 segundos |
| Resoluções disponíveis | 360p, 720p, 1080p, 4k | 360p, 720p, 1080p, 4k | 360p, 720p, 1080p, 4k | 360p, 720p, 1080p, 4k |
| Proporções de tela | 16:9, 9:16 | 16:9, 9:16 | Sem suporte | 16:9, 9:16 |
| Entradas opcionais | Nenhuma | Imagem final | Nenhuma | Até 10 imagens e 3 vídeos, com pelo menos uma referência |

## Endpoint compartilhado

Todas as variantes do Gemini Omni 1.2 Flash usam o endpoint de tarefas de vídeo:

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

## Gemini Omni 1.2 Flash Text to Video

### Parâmetros obrigatórios

| Parâmetro | Tipo | Descrição |
|-----------|------|-------------|
| `model_name` | string | Deve ser `"gemini-omni-1.2-flash-text-to-video"` |
| `prompt` | string | Descrição em texto do vídeo a gerar |
| `aspect_ratio` | string | Proporção de tela do vídeo de saída: `"16:9"` ou `"9:16"` |
| `resolution` | string | Resolução de saída: `"360p"`, `"720p"`, `"1080p"` ou `"4k"` |
| `duration` | integer | Duração de saída em segundos, de 3 a 15 |

### Exemplo de requisição

```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 obrigatórios

| Parâmetro | Tipo | Descrição |
|-----------|------|-------------|
| `model_name` | string | Deve ser `"gemini-omni-1.2-flash-image-to-video"` |
| `prompt` | string | Descrição em texto do movimento desejado e da evolução da cena |
| `image_url` | string | URL da imagem obrigatória do quadro inicial |
| `aspect_ratio` | string | Proporção de tela do vídeo de saída: `"16:9"` ou `"9:16"` |
| `resolution` | string | Resolução de saída: `"360p"`, `"720p"`, `"1080p"` ou `"4k"` |
| `duration` | integer | Duração de saída em segundos, de 3 a 15 sem quadro final ou de 3 a 10 quando se informa `image_end_url` |

### Parâmetros opcionais

| Parâmetro | Tipo | Descrição |
|-----------|------|-------------|
| `image_end_url` | string | URL opcional da imagem do quadro final. Quando informado, `duration` deve estar entre 3 e 10 segundos |

### Exemplo de requisição

```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 obrigatórios

| Parâmetro | Tipo | Descrição |
|-----------|------|-------------|
| `model_name` | string | Deve ser `"gemini-omni-1.2-flash-video-edit"` |
| `prompt` | string | Instruções em texto que descrevem a edição desejada |
| `video_url` | string | URL do vídeo de origem. O vídeo deve ter no máximo 10 segundos |
| `resolution` | string | Resolução de saída: `"360p"`, `"720p"`, `"1080p"` ou `"4k"` |

**Observação:** A variante Video Edit não aceita `aspect_ratio` nem `duration`. Omita os dois parâmetros da requisição.

### Exemplo de requisição

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

As imagens e os vídeos de referência podem ser usados separadamente ou em conjunto. Informe pelo menos uma imagem ou um vídeo de referência em `images` ou `videos`.

### Parâmetros obrigatórios

| Parâmetro | Tipo | Descrição |
|-----------|------|-------------|
| `model_name` | string | Deve ser `"gemini-omni-1.2-flash-reference-to-video"` |
| `prompt` | string | Descrição em texto do vídeo a gerar |
| `aspect_ratio` | string | Proporção de tela do vídeo de saída: `"16:9"` ou `"9:16"` |
| `resolution` | string | Resolução de saída: `"360p"`, `"720p"`, `"1080p"` ou `"4k"` |
| `duration` | integer | Duração de saída em segundos, de 3 a 15 |

### Entradas de referência opcionais

| Parâmetro | Tipo | Descrição |
|-----------|------|-------------|
| `images` | string[] | Até 10 URLs de imagens de referência. Opcional quando se fornecem vídeos de referência |
| `videos` | string[] | Até 3 URLs de vídeos de referência. Cada vídeo deve ter no máximo 3 segundos. Opcional quando se fornecem imagens de referência |

### Exemplo de requisição

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

### Resposta inicial

Todos os modelos retornam um `task_id` para consultas periódicas de status:

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

### Resposta à consulta periódica

Faça consultas periódicas com `GET /api/v1/video/{taskId}` para verificar o status:

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

- `submitted`: tarefa aceita e aguardando processamento
- `processing`: geração do vídeo em andamento
- `succeed`: geração do vídeo concluída
- `failed`: falha na geração do vídeo

## Boas práticas

1. **Instruções de texto**: descreva com clareza os elementos em cena, as ações, o movimento da câmera, a iluminação e a evolução da cena.
2. **Configurações obrigatórias**: sempre informe uma resolução compatível. Exceto na variante Video Edit, informe também uma proporção de tela e uma duração compatíveis.
3. **Imagens de entrada**: use URLs estáveis e acessíveis publicamente para as imagens iniciais, finais e de referência. Ao fornecer uma imagem de quadro final, mantenha `duration` entre 3 e 10 segundos.
4. **Vídeo para edição**: verifique se o vídeo de origem tem no máximo 10 segundos antes de enviá-lo.
5. **Limites das referências**: forneça pelo menos uma imagem ou um vídeo de referência. Envie no máximo 10 imagens e 3 vídeos, cada vídeo com até 3 segundos.