API de Gemini Omni 1.1 Flash

Referencia completa de la API para los modelos de generación de video Google Gemini Omni 1.1 Flash.

Variantes del modelo

Esta API admite cuatro variantes del modelo:

Comparación rápida

Endpoint compartido

Todas las variantes de Gemini Omni 1.1 Flash usan el endpoint de tareas de video:

POST /api/v1/video/task

Gemini Omni 1.1 Flash Text to Video

Parámetros obligatorios

Solicitud de ejemplo

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.1-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: 8
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Gemini Omni 1.1 Flash Image to Video

Parámetros obligatorios

Parámetros opcionales

Solicitud de ejemplo

javascriptCopiar
{
  model_name: 'gemini-omni-1.1-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.1 Flash Video Edit

Parámetros obligatorios

Nota: Video Edit no admite aspect_ratio ni duration. No incluya ninguno de estos parámetros en la solicitud.

Solicitud de ejemplo

javascriptCopiar
{
  model_name: 'gemini-omni-1.1-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.1 Flash Reference to Video

Las imágenes y los videos de referencia son opcionales y pueden usarse por separado o conjuntamente.

Parámetros obligatorios

Entradas de referencia opcionales

Solicitud de ejemplo

javascriptCopiar
{
  model_name: 'gemini-omni-1.1-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: 8,
  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 su estado:

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

Consulte 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": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Valores de estado

• submitted: Tarea aceptada y en espera de ser procesada
• processing: Generación de video en curso
• succeed: Generación de video completada
• failed: Error en la generación de video

Prácticas recomendadas

1. Instrucciones precisas: Describa claramente los sujetos, las acciones, el movimiento de la cámara, la iluminación y la progresión de la escena.
2. Ajustes obligatorios: Proporcione siempre una resolución compatible y, excepto para Video Edit, una relación de aspecto y una duración compatibles.
3. Entradas de imagen: Use URL estables y de acceso público para las imágenes iniciales, finales y de referencia.
4. Entrada de Video Edit: Verifique que el video de origen dure entre 3 y 10 segundos antes de enviarlo.
5. Límites de referencias: No envíe más de 10 imágenes y 3 videos, y asegúrese de que cada video de referencia dure 3 segundos o menos.