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.
/v1beta/interactions/{id}Autorización
bearerAuth Usa una API Key de la plataforma actual.
Ubicación: header
Parámetros de ruta
ID de interacción devuelto por la API de creación.
1 <= lengthCuerpo 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 += 1La respuesta REST no usa la propiedad auxiliar del SDK output_video. Para enviar una tarea nueva, usa Crear vídeo.