動画をアップスケールする

Gemini Omni 1.2 Flash を使用すると、Agent Platform API を使用して、低解像度（360p または 720p）の動画を高解像度（720p、1080p、4K）にアップスケールできます。スタンドアロンの動画アップスケーリングを使用すると、低解像度でプロンプトを繰り返し、最終的に選択した動画のみをアップスケーリングできます。アップスケーリングは、前のターンから、または Cloud Storage に保存されている以前に生成された動画から行うことができます。

注: スタンドアロンの動画アップスケーリングは、Gemini Omni モデルで生成された動画向けに設計、最適化されています。Gemini Omni で生成されていない動画をアップスケールすると、出力品質が異なる場合があります。

次のモデルは、動画のアップスケーリングをサポートしています。

クリックしてサポートされているモデルを開く

• gemini-omni-1.2-flash

サポートされている解像度と仕様

スタンドアロン動画アップスケーリングは、次の解像度変換と入力制約をサポートしています。

• 360p 入力動画: 720p または 1080p にアップスケールします。1 つのリクエストで 360p から 4k に直接アップスケールすることはできません。
• 720p 入力動画: 1080p または 4k にアップスケールします。1080p から 4k へのアップスケーリングはサポートされていません。
• アスペクト比: 16:9（横向き）または 9:16（縦向き）。
• フレームレート: 24 フレーム/秒（出力動画で保持）。
• 時間: 15 秒以内。
• トークンの使用量と料金: スタンドアロンの動画アップスケーリングでは、テキスト推論がバイパスされ、入力トークン（total_input_tokens: 0）は常にゼロになります。出力動画トークンは、ソースとターゲットの解像度ペアに基づいて、他のすべての Omni 1.2 Flash タスクと同じ出力動画トークン料金で課金されます（360p から 720p、720p から 1080p の場合は 1 秒あたり 2,896 出力動画トークン、360p から 1080p の場合は 1 秒あたり 5,792 出力動画トークン、720p から 4k の場合は 1 秒あたり 11,584 出力動画トークン）。

リクエストの要件

スタンドアロンの動画アップスケーリング リクエストを送信する場合は、リクエストが次の要件を満たしていることを確認してください。

• task: "upscale" を指定する: generation_config.video_config.task を "upscale" に設定する必要があります。task: "upscale" を省略すると、API はリクエストを動画編集（"edit"）オペレーションとして解釈します。
• ターゲット resolution を指定する: response_format でターゲット resolution（"720p"、"1080p"、"4k"）を指定する必要があります。ターゲット resolution を省略すると、エラーが返されます。
• 動画ソースを指定する: input（"type": "video"）で入力動画を指定するか、previous_interaction_id を設定して、直前のステートフル ターンで生成された動画をアップスケールします。マルチターン インタラクションでは、アップスケールする動画を特定する際に、直前のターンのみが考慮されます。
• オプション パラメータ: 再現可能な出力に generation_config.seed を指定し、カスタム メタデータ ラベル（labels）をアタッチして、リクエストを整理し、請求額を追跡できます。

Colab で Gemini Omni を試す

始める前に

Google Cloud アカウントにログインします。 Google Cloudを初めて使用する場合は、 アカウントを作成して、実際のシナリオで Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Enable the Agent Platform API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Enable the Agent Platform API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

1. 環境の認証を設定します。

   このページのサンプルをどのように使うかに応じて、タブを選択してください。

   コンソール

   Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。

   REST

   このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

   Google Cloud CLI をインストールします。

   外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

   詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

Omni 1.2 Flash を使用して動画をアップスケールする

Omni 1.2 Flash を使用して動画をアップスケールするには、次のいずれかのインタラクション モードを選択します。

REST

動画のアップスケーリングが完了するまでに 1 分以上かかることがあります。ワークフローに応じて、いくつかのインタラクション モードから選択できます。

• 同期: ステートレス（アップロードされた動画）: store を false に設定すると、サーバーにインタラクション状態を保持せずに、1 回のリクエストで Cloud Storage から 360p または 720p の動画をアップスケールできます。
• 同期: ステートフル（前のターン）: 直前のステートフル ターンの previous_interaction_id を参照して、以前に生成された 360p または 720p の動画をアップスケールします。
• 同期: ステートフル ストリーミング: store と stream の両方を true に設定して、インタラクション ステータスの更新と出力動画をストリーミングします。
• 非同期: background を true に設定して、動画のアップスケーリングをバックグラウンドで実行し、後でインタラクション ID を使用して結果を取得します。

保存されたインタラクションと非同期インタラクションは、最大 7 日間保持されます。

Interactions API で Gemini Omni モデルを使用する方法については、Interactions API をご覧ください。

同期: ステートレス

リクエストのデータを使用する前に、次のように置き換えます。

• PROJECT_ID: Google Cloud プロジェクト ID を表す文字列。
• MODEL_ID: 使用するモデル ID を表す文字列。指定できる値は次のとおりです。
  • "gemini-omni-1.2-flash"
• CLOUD_STORAGE_VIDEO_URI: 入力動画（360p または 720p、最大 15 秒）を含む Cloud Storage URI を表す文字列。たとえば "gs://video-bucket/input/video.mp4"。
• VIDEO_MIME: 動画の MIME タイプを表す文字列。指定できる値は次のとおりです。
  • video/3gpp
  • video/mp4
  • video/mpeg
  • video/quicktime
  • video/webm
  • video/x-flv
  • video/x-ms-wmv
• CLOUD_STORAGE_OUTPUT_URI: 省略可。アップスケールされた動画を保存する Cloud Storage バケットを表す文字列。指定しない場合、動画のバイト数がレスポンスで返されます。例: "gs://video-bucket/output/"
• OUTPUT_RESOLUTION: 必須。ターゲット出力解像度を表す文字列。サポートされている値は、入力動画の解像度によって異なります。
  • 360p の入力動画の場合: "720p" または "1080p"
  • 720p の入力動画の場合: "1080p" または "4k"

HTTP メソッドと URL:

POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions

リクエストの本文（JSON）:

{
  "model": "MODEL_ID",
  "store": false,
  "input": [
    {
      "type": "video",
      "uri": "CLOUD_STORAGE_VIDEO_URI",
      "mime_type": "VIDEO_MIME"
    }
  ],
  "response_format": [
    {
      "type": "video",
      "delivery": "uri",
      "gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
      "resolution": "OUTPUT_RESOLUTION"
    }
  ],
  "generation_config": {
    "video_config": {
      "task": "upscale"
    }
  }
}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer TOKEN" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"

PowerShell

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions" | Select-Object -Expand Content

レスポンスには、アップスケールされた出力動画とのインタラクションと、ゼロの入力トークンが含まれます。

{
  "id": "INTERACTION_ID",
  "model": "gemini-omni-1.2-flash",
  "status": "completed",
  "usage": {
    "total_tokens": 28960,
    "total_input_tokens": 0,
    "output_tokens_by_modality": [
      {
        "modality": "video",
        "tokens": 28960
      }
    ],
    "total_output_tokens": 28960
  },
  "steps": [
    { 
      "type": "model_output",
      "content": [
        {
          "type": "video",
          "uri": "gs://some/output_path/123.mp4",
          "mime_type": "video/mp4" 
        }
      ]
    }
  ],
  "object": "interaction",
  "role": "model",
  "created": "2026-11-05T02:17:56Z",
  "updated": "2026-11-05T02:17:56Z"
}

同期: ステートフル

リクエストのデータを使用する前に、次のように置き換えます。

• PROJECT_ID: Google Cloud プロジェクト ID を表す文字列。
• MODEL_ID: 使用するモデル ID を表す文字列。指定できる値は次のとおりです。
  • "gemini-omni-1.2-flash"
• PREVIOUS_INTERACTION_ID: 360p または 720p の動画（最大 15 秒）を生成した直前のステートフル ターンのインタラクション ID。
• CLOUD_STORAGE_OUTPUT_URI: 省略可。アップスケールされた動画を保存する Cloud Storage バケットを表す文字列。指定しない場合、動画のバイト数がレスポンスで返されます。例: "gs://video-bucket/output/"
• OUTPUT_RESOLUTION: 必須。ターゲット出力解像度を表す文字列。サポートされている値は、前のターンの動画解像度によって異なります。
  • 360p の動画の場合: "720p" または "1080p"
  • 720p の動画の場合: "1080p" または "4k"

HTTP メソッドと URL:

POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions

リクエストの本文（JSON）:

{
  "model": "MODEL_ID",
  "previous_interaction_id": "PREVIOUS_INTERACTION_ID",
  "background": false,
  "store": true,
  "stream": false,
  "input": [
    {
      "type": "user_input",
      "content": [
        {
          "type": "text",
          "text": "Upsample video."
        }
      ]
    }
  ],
  "response_format": [
    {
      "type": "video",
      "delivery": "uri",
      "gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
      "resolution": "OUTPUT_RESOLUTION"
    }
  ],
  "generation_config": {
    "video_config": {
      "task": "upscale"
    }
  }
}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer TOKEN" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"

PowerShell

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions" | Select-Object -Expand Content

レスポンスには、アップスケールされた出力動画とのインタラクションと、ゼロの入力トークンが含まれます。

{
  "id": "INTERACTION_ID",
  "previous_interaction_id": "PREVIOUS_INTERACTION_ID",
  "model": "gemini-omni-1.2-flash",
  "status": "completed",
  "usage": {
    "total_tokens": 28960,
    "total_input_tokens": 0,
    "output_tokens_by_modality": [
      {
        "modality": "video",
        "tokens": 28960
      }
    ],
    "total_output_tokens": 28960
  },
  "steps": [
    { 
      "type": "model_output",
      "content": [
        {
          "type": "video",
          "uri": "gs://some/output_path/123.mp4",
          "mime_type": "video/mp4" 
        }
      ]
    }
  ],
  "object": "interaction",
  "role": "model",
  "created": "2026-11-05T02:17:56Z",
  "updated": "2026-11-05T02:17:56Z"
}

INTERACTION_ID を使用して、アップスケールされた動画を取得します。

リクエストのデータを使用する前に、次のように置き換えます。

• PROJECT_ID: Google Cloud プロジェクト ID を表す文字列。
• INTERACTION_ID: 非同期リクエストのインタラクション ID。

HTTP メソッドと URL:

GET https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

次のコマンドを実行します。

curl -X GET \
     -H "Authorization: Bearer TOKEN" \
     "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID"

PowerShell

次のコマンドを実行します。

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID" | Select-Object -Expand Content

レスポンスは次の例のような形式になります。

{
  "id":"INTERACTION_ID",
  "model":"gemini-omni-1.2-flash",
  "status":"completed",
  "usage":{
    "total_tokens":479,
    "total_input_tokens":26,
    "input_tokens_by_modality":[
      {
        "modality":"text",
        "tokens":26
      },
      {
        "modality":"image",
        "tokens":124
      }
    ],
    "output_tokens_by_modality": [
      {
        "modality": "video",
        "tokens": 28832
      }
    ],
    "total_output_tokens":28832,
    "total_thought_tokens":453
  },
  "steps":[
    {
      "type": "user_input",
      "content": [
        {
          "type": "text",
          "text": "5 second, 9:16 video. Use the image as the first frame."
        },
        {
          "type": "image",
          "uri": "gs://some/path",
          "mime_type": "image/png"
        }
      ]
    },
    {
      "type":"thought",
      "summary":[
        {
          "type":"text",
          "text":"MODEL THOUGHTS"
        }
      ]
    },
    { 
      "type":"model_output",
      "content":[
        {
          "type":"video",
          "data":"VIDEO DATA",
          "mime_type":"video/mp4" 
        }
      ]
    }
  ],
  "object":"interaction",
  "role":"model",
  "created":"2026-05-29T02:17:56Z",
  "updated":"2026-05-29T02:17:56Z"
}

同期: ステートフル ストリーミング

リクエストのデータを使用する前に、次のように置き換えます。

• PROJECT_ID: Google Cloud プロジェクト ID を表す文字列。
• MODEL_ID: 使用するモデル ID を表す文字列。指定できる値は次のとおりです。
  • "gemini-omni-1.2-flash"
• CLOUD_STORAGE_VIDEO_URI: 入力動画（360p または 720p、最大 15 秒）を含む Cloud Storage URI を表す文字列。たとえば "gs://video-bucket/input/video.mp4"。
• VIDEO_MIME: 動画の MIME タイプを表す文字列。指定できる値は次のとおりです。
  • video/3gpp
  • video/mp4
  • video/mpeg
  • video/quicktime
  • video/webm
  • video/x-flv
  • video/x-ms-wmv
• CLOUD_STORAGE_OUTPUT_URI: 省略可。アップスケールされた動画を保存する Cloud Storage バケットを表す文字列。指定しない場合、動画のバイト数がレスポンスで返されます。例: "gs://video-bucket/output/"
• OUTPUT_RESOLUTION: 必須。ターゲット出力解像度を表す文字列。サポートされている値は、入力動画の解像度によって異なります。
  • 360p の入力動画の場合: "720p" または "1080p"
  • 720p の入力動画の場合: "1080p" または "4k"

HTTP メソッドと URL:

POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions

リクエストの本文（JSON）:

{
  "model": "MODEL_ID",
  "background": false,
  "store": true,
  "stream": true,
  "input": [
    {
      "type": "user_input",
      "content": [
        {
          "type": "video",
          "uri": "CLOUD_STORAGE_VIDEO_URI",
          "mime_type": "VIDEO_MIME"
        }
      ]
    }
  ],
  "response_format": [
    {
      "type": "video",
      "delivery": "uri",
      "gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
      "resolution": "OUTPUT_RESOLUTION"
    }
  ],
  "generation_config": {
    "video_config": {
      "task": "upscale"
    }
  }
}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer TOKEN" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"

PowerShell

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions" | Select-Object -Expand Content

レスポンスは、アップスケールされた出力動画を含むサーバー送信イベント（SSE）のストリームです。

event: interaction.created
data: {"interaction":{"id":"INTERACTION_ID","status":"in_progress","object":"interaction","model":"gemini-omni-1.2-flash"},"event_type":"interaction.created"}

event: interaction.status_update
data: {"interaction_id":"INTERACTION_ID","status":"in_progress","event_type":"interaction.status_update"}

event: step.start
data: {"index":0,"step":{"type":"model_output"},"event_type":"step.start"}

event: step.delta
data: {"index":0,"delta":{"mime_type":"video/mp4","uri":"gs://some/output_path/123.mp4","type":"video"},"event_id":"EVENT_ID","event_type":"step.delta"}

event: step.stop
data: {"index":0,"event_type":"step.stop"}

event: interaction.completed
data: {"interaction":{"id":"INTERACTION_ID","status":"completed","usage":{"total_tokens":28960,"total_input_tokens":0,"total_output_tokens":28960,"output_tokens_by_modality":[{"modality":"video","tokens":28960}]},"created":"2026-11-05T21:26:20Z","updated":"2026-11-05T21:26:20Z","event_id":"EVENT_ID","object":"interaction","model":"gemini-omni-1.2-flash"},"event_id":"EVENT_ID","event_type":"interaction.completed"}

event: done
data: [DONE]

`?stream=true` を指定して INTERACTION_ID を使用し、保存されたインタラクションとアップスケールされた動画をストリーミングします。

リクエストのデータを使用する前に、次のように置き換えます。

• PROJECT_ID: Google Cloud プロジェクト ID を表す文字列。
• INTERACTION_ID: リクエストのインタラクション ID。

HTTP メソッドと URL:

GET https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID?stream=true

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

次のコマンドを実行します。

curl -X GET \
     -H "Authorization: Bearer TOKEN" \
     "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID?stream=true"

PowerShell

次のコマンドを実行します。

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID?stream=true" | Select-Object -Expand Content

レスポンスは、次のような形式のサーバー送信イベント（SSE）のストリームです。

event: interaction.created
data: {"interaction":{"id":"INTERACTION_ID","status":"in_progress","object":"interaction","model":"gemini-omni-1.2-flash"},"event_type":"interaction.created"}

event: interaction.status_update
data: {"interaction_id":"INTERACTION_ID","status":"in_progress","event_type":"interaction.status_update"}

event: step.start
data: {"index":0,"step":{"type":"thought"},"event_type":"step.start"}

event: step.delta
data: {"index":0,"delta":{"content":{"text":"MODEL THOUGHTS","type":"text"},"type":"thought_summary"},"event_id":"EVENT_ID","event_type":"step.delta"}

event: step.delta
data: {"index":0,"delta":{"content":{"text":"MODEL THOUGHTS","type":"text"},"type":"thought_summary"},"event_id":"EVENT_ID","event_type":"step.delta"}

event: step.delta
data: {"index":0,"delta":{"signature":"...","type":"thought_signature"},"event_type":"step.delta"}

event: step.stop
data: {"index":0,"event_type":"step.stop"}

event: step.start
data: {"index":1,"step":{"type":"model_output"},"event_type":"step.start"}

event: step.delta
data: {"index":1,"delta":{"mime_type":"video/mp4","uri":"gs://some/output_path/123.mp4","type":"video"},"event_id":"EVENT_ID","event_type":"step.delta"}

event: step.stop
data: {"index":1,"event_type":"step.stop"}

event: interaction.completed
data: {"interaction":{"id":"INTERACTION_ID","status":"completed","usage":{"total_tokens":17664,"total_input_tokens":21,"input_tokens_by_modality":[{"modality":"text","tokens":21}],"total_output_tokens":17376,"output_tokens_by_modality":[{"modality":"video","tokens":17376}],"total_thought_tokens":267},"created":"2026-08-12T21:33:08Z","updated":"2026-08-12T21:33:08Z","event_id":"EVENT_ID","object":"interaction","model":"gemini-omni-1.2-flash"},"event_id":"EVENT_ID","event_type":"interaction.completed"}

event: done
data: [DONE]

非同期

リクエストのデータを使用する前に、次のように置き換えます。

• PROJECT_ID: Google Cloud プロジェクト ID を表す文字列。
• MODEL_ID: 使用するモデル ID を表す文字列。指定できる値は次のとおりです。
  • "gemini-omni-1.2-flash"
• CLOUD_STORAGE_VIDEO_URI: 入力動画（360p または 720p、最大 15 秒）を含む Cloud Storage URI を表す文字列。たとえば "gs://video-bucket/input/video.mp4"。
• VIDEO_MIME: 動画の MIME タイプを表す文字列。指定できる値は次のとおりです。
  • video/3gpp
  • video/mp4
  • video/mpeg
  • video/quicktime
  • video/webm
  • video/x-flv
  • video/x-ms-wmv
• CLOUD_STORAGE_OUTPUT_URI: 省略可。アップスケールされた動画を保存する Cloud Storage バケットを表す文字列。指定しない場合、動画のバイト数がレスポンスで返されます。例: "gs://video-bucket/output/"
• OUTPUT_RESOLUTION: 必須。ターゲット出力解像度を表す文字列。サポートされている値は、入力動画の解像度によって異なります。
  • 360p の入力動画の場合: "720p" または "1080p"
  • 720p の入力動画の場合: "1080p" または "4k"

HTTP メソッドと URL:

POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions

リクエストの本文（JSON）:

{
  "model": "MODEL_ID",
  "background": true,
  "input": [
    {
      "type": "video",
      "uri": "CLOUD_STORAGE_VIDEO_URI",
      "mime_type": "VIDEO_MIME"
    }
  ],
  "response_format": [
    {
      "type": "video",
      "delivery": "uri",
      "gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
      "resolution": "OUTPUT_RESOLUTION"
    }
  ],
  "generation_config": {
    "video_config": {
      "task": "upscale"
    }
  }
}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer TOKEN" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"

PowerShell

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions" | Select-Object -Expand Content

レスポンスには、アップスケールされた動画の取得に使用するインタラクション ID が含まれています。

{
  "id": "INTERACTION_ID",
  "status": "in_progress",
  "object": "interaction"
}

後で INTERACTION_ID を使用して、アップスケールされた動画を取得します。

リクエストのデータを使用する前に、次のように置き換えます。

• PROJECT_ID: Google Cloud プロジェクト ID を表す文字列。
• INTERACTION_ID: 非同期リクエストのインタラクション ID。

HTTP メソッドと URL:

GET https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

次のコマンドを実行します。

curl -X GET \
     -H "Authorization: Bearer TOKEN" \
     "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID"

PowerShell

次のコマンドを実行します。

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID" | Select-Object -Expand Content

レスポンスは次の例のような形式になります。

{
  "id":"INTERACTION_ID",
  "model":"gemini-omni-1.2-flash",
  "status":"completed",
  "usage":{
    "total_tokens":479,
    "total_input_tokens":26,
    "input_tokens_by_modality":[
      {
        "modality":"text",
        "tokens":26
      },
      {
        "modality":"image",
        "tokens":124
      }
    ],
    "output_tokens_by_modality": [
      {
        "modality": "video",
        "tokens": 28832
      }
    ],
    "total_output_tokens":28832,
    "total_thought_tokens":453
  },
  "steps":[
    {
      "type": "user_input",
      "content": [
        {
          "type": "text",
          "text": "5 second, 9:16 video. Use the image as the first frame."
        },
        {
          "type": "image",
          "uri": "gs://some/path",
          "mime_type": "image/png"
        }
      ]
    },
    {
      "type":"thought",
      "summary":[
        {
          "type":"text",
          "text":"MODEL THOUGHTS"
        }
      ]
    },
    { 
      "type":"model_output",
      "content":[
        {
          "type":"video",
          "data":"VIDEO DATA",
          "mime_type":"video/mp4" 
        }
      ]
    }
  ],
  "object":"interaction",
  "role":"model",
  "created":"2026-05-29T02:17:56Z",
  "updated":"2026-05-29T02:17:56Z"
}

次のステップ

• 動画生成プロンプト ガイド

• 動画生成のベスト プラクティス

• テキスト プロンプトから動画を生成する

• 画像から動画を生成する

• 最初と最後の動画フレームを使用して動画を生成する

• 参照から動画を生成する

• 動画を編集する

• 動画を拡張する

• Gemini Enterprise Agent Platform の Veo に関する責任ある AI と使用上のガイドラインについて確認する