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:

Comparación rápida

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

Ejemplo de solicitud

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 obligatorios

Parámetros opcionales

Ejemplo de solicitud

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 obligatorios

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

Ejemplo de solicitud

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

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

Referencias opcionales

Ejemplo de solicitud

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 de respuesta

Respuesta inicial

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

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

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