AGTCloud API Docs
Referencia de API
Generación de videoGemini Omni

Consultar un vídeo Gemini Omni 1.2 Flash

Consulta el estado y el resultado generado de una interacción de vídeo Gemini Omni 1.2 Flash.

Usa el ID de interacción devuelto por la API de creación para consultar el estado, el contenido generado y el uso.

GET/v1beta/interactions/{id}

Autorización

bearerAuth
AutorizaciónBearer <token>

Usa una API Key de la plataforma actual.

Ubicación: header

Parámetros de ruta

id*string

ID de interacción devuelto por la API de creación.

Longitud1 <= length

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

application/json

Leer y guardar el vídeo

HTTP 200 solo indica que la consulta fue correcta; comprueba el estado de la tarea. Continúa las consultas periódicas solo con in_progress. Si la tarea termina, falla o requiere una acción, deja de consultar sin cambios y trata el estado correspondiente. Busca un paso model_output en steps, localiza contenido type: "video" dentro de content y decodifica data.

Cuando la tarea termine correctamente, usa Descargar vídeo para guardar el archivo directamente o decodifica tú mismo el Base64 de la respuesta.

Si la consulta encuentra límites de frecuencia o errores temporales, vuelve a intentarlo con espera progresiva.

El siguiente ejemplo de Python lee una respuesta correcta guardada en response.json y decodifica el vídeo en un archivo local. BASE64_ENCODED_VIDEO es un marcador ilustrativo y no puede decodificarse como vídeo.

import base64
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8"))
video_index = 0
for step in response.get("steps", []):
    if step.get("type") != "model_output":
        continue
    for item in step.get("content", []):
        if item.get("type") == "video" and item.get("data"):
            Path(f"video-{video_index}.mp4").write_bytes(
                base64.b64decode(item["data"], validate=True)
            )
            video_index += 1

La respuesta REST no usa la propiedad auxiliar del SDK output_video. Para enviar una tarea nueva, usa Crear vídeo.

Documentación oficial de Google Gemini Omni para consultar interaccionesConsulta la definición del protocolo de origen y los últimos cambios en los campos.