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:

Comparação rápida

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

Exemplo de requisição

javascriptCopiar
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âmetros opcionais

Exemplo de requisição

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

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

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

Entradas de referência opcionais

Exemplo de requisição

javascriptCopiar
{
  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:

jsonCopiar
{
  "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:

jsonCopiar
{
  "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.