> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Veo 3.1 画像から動画生成

<Info>
  Veo 3.1 Preview バージョンの API は、このインターフェースに自動的に互換対応されています
</Info>

Veo 3.1 動画生成モデルを使用して、入力画像とテキスト説明から高品質な動画コンテンツを生成します。このインターフェースは非同期処理方式を採用しており、最終的な生成結果を取得するには task\_id で照会する必要があります。

## リクエストヘッダー

<ParamField header="Content-Type" type="string" required={true}>
  列挙値: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 認証形式: Bearer \{\{API Key}}。
</ParamField>

## リクエストボディ

<ParamField body="prompt" type="string" required={true}>
  生成したい動画を説明するテキスト文字列。
</ParamField>

<ParamField body="image" type="string" required={false}>
  入力画像。URL または base64 エンコード形式に対応しています。
</ParamField>

<ParamField body="last_image" type="string" required={false}>
  終了画像。動画の最後のフレーム画像を埋めるために使用します。URL または base64 エンコード形式に対応しています。
</ParamField>

<ParamField body="reference_images" type="object[]" required={false}>
  最大 3 枚の `asset` 画像、または最大 1 枚の `style` 画像のリスト。モデルが動画を生成する際に使用する参照画像を記述するために使用します。

  <Expandable title="properties">
    <ParamField body="image" type="string" required={false}>
      参照画像。URL または base64 エンコード形式に対応しています。
    </ParamField>

    <ParamField body="reference_type" type="string" required={true}>
      提供された参照画像のタイプを指定します。以下の値に対応しています：

      * `asset`: 参照画像は、生成される動画にシーン、物体、キャラクターなどのアセットを提供します。
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="aspect_ratio" type="string" required={false}>
  生成する動画のアスペクト比を指定します。

  列挙値: `16:9`、`9:16`。デフォルト値は `16:9` です。
</ParamField>

<ParamField body="duration_seconds" type="integer" required={false}>
  生成したい動画ファイルの長さ（秒）。

  列挙値: `4`、`6`、`8`。`reference_images` を使用する場合は `8` のみ指定できます。

  デフォルト値は `8` です。
</ParamField>

<ParamField body="enhance_prompt" type="boolean" required={false}>
  Gemini を使用してプロンプトを強化するかどうかを指定します。`true` のみ対応しています。

  デフォルト値: `true`
</ParamField>

<ParamField body="generate_audio" type="boolean" required={true}>
  動画に音声を生成するかどうかを指定します。
</ParamField>

<ParamField body="negative_prompt" type="string" required={false}>
  モデルに生成させたくない内容を説明するテキスト文字列。
</ParamField>

<ParamField body="person_generation" type="string" required={false}>
  人物または顔の生成を許可するかどうかを制御する安全設定。

  列挙値:

  * `allow_adult` (デフォルト): 成人のみ生成を許可
  * `dont_allow`: 画像内に人物または顔を含めることを許可しない
  * `allow_all`: すべての年齢層の人物の生成を許可（プロジェクトが allowlist に含まれている必要があります）
</ParamField>

<ParamField body="resolution" type="string" required={false}>
  生成する動画の解像度。

  列挙値: `720p` (デフォルト) または `1080p`
</ParamField>

<ParamField body="sample_count" type="integer" required={false}>
  生成する動画サンプルの数。

  値の範囲: 1-4
</ParamField>

<ParamField body="seed" type="uint32" required={false}>
  ランダム生成プロセスを初期化するための数値。同じシード、プロンプト、その他のパラメータを使用すると同じ出力動画が生成され、生成プロセスに決定性を持たせることができます。

  値の範囲: 0-4,294,967,295
</ParamField>

## レスポンス情報パラメータ

<ResponseField name="task_id" type="string" required={true}>
  非同期タスクの task\_id。この task\_id を使用して [タスク結果照会 API](/ja/docs/models/reference-get-async-task-result) にリクエストし、生成結果を取得してください
</ResponseField>