> ## 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="aspect_ratio" type="string" required={false}>
  生成する動画のアスペクト比を指定します。

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

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

  列挙値: `4`、`6`、`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}>
  ランダム生成プロセスの初期化に使用する数値。同じ seed、プロンプト、その他のパラメータを使用すると同じ出力動画が生成され、生成プロセスが決定的になります。

  取値範囲: 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>