AGTCloud API Docs
가이드API 레퍼런스통합 및 리소스업데이트 및 도움말
비디오 생성Gemini Omni

Gemini Omni 1.2 Flash 영상 조회

Gemini Omni 1.2 Flash 영상 상호작용의 상태와 생성 결과를 조회합니다.

생성 API가 반환한 상호작용 ID로 영상 상태, 생성 내용 및 사용량을 조회합니다.

GET/v1beta/interactions/{id}

인증

bearerAuth
인증Bearer <token>

현재 플랫폼의 API Key를 사용합니다.

전달 위치: header

경로 매개변수

id*string

생성 API가 반환한 상호작용 ID.

길이1 <= length

응답 본문

application/json

application/json

application/json

application/json

영상 읽기 및 저장

HTTP 200은 조회 성공만 나타내므로 작업 상태를 확인하세요. in_progress일 때만 폴링을 계속합니다. 완료, 실패 또는 추가 동작이 필요하면 같은 폴링을 중단하고 상태에 따라 처리합니다. steps에서 model_output 단계를 찾아 content의 type: "video" 항목에 있는 data를 디코딩합니다.

작업 성공 후 영상 다운로드로 파일을 바로 저장하거나 응답의 Base64를 직접 디코딩할 수 있습니다.

조회 시 속도 제한이나 일시적 오류가 발생하면 대기 시간을 늘리며 재시도하세요.

아래 Python 예시는 response.json에 저장한 성공 응답을 읽고 영상을 로컬 파일로 디코딩합니다. BASE64_ENCODED_VIDEO는 설명용 표시이며 영상으로 디코딩할 수 없습니다.

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

REST 응답은 SDK 편의 속성 output_video를 사용하지 않습니다. 새 작업을 제출하려면 영상 생성을 사용하세요.

Google Gemini Omni 상호작용 조회 공식 문서상위 프로토콜 정의와 최신 필드 변경 사항을 확인하세요.