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

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 インタラクション取得の公式ドキュメント上流プロトコルの定義と最新のフィールド変更を確認できます。