> ## 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 参考画像による動画生成

Google Veo 3.1 モデルを使用し、1〜3枚の参考画像で動画生成をガイドします。720p と 1080p の解像度、16:9 と 9:16 のアスペクト比に対応しています。長さは8秒固定です。参照タイプは asset のみ対応しています。

<Tip>
  これは**非同期**APIであり、非同期タスクの task\_id のみを返します。この task\_id を使用して [タスク結果照会 API](/ja/docs/models/reference-get-async-task-result) にリクエストし、生成結果を取得してください。
</Tip>

## リクエストヘッダー

<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="seed" type="integer">
  生成結果を再現するためのランダムシード。

  値の範囲：\[0, 4294967295]
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  期待する動画内容を説明するテキストプロンプト。
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  出力動画の解像度。

  指定可能な値：`720p`, `1080p`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  出力動画のアスペクト比。

  指定可能な値：`16:9`, `9:16`
</ParamField>

<ParamField body="sample_count" type="integer" default={1}>
  生成する動画サンプル数（1〜4）。

  値の範囲：\[1, 4]
</ParamField>

<ParamField body="enhance_prompt" type="boolean" default={true}>
  より良い生成結果を得るために、AIでプロンプトを書き換えるかどうか。
</ParamField>

<ParamField body="generate_audio" type="boolean" default={false}>
  音声も同時に生成するかどうか。
</ParamField>

<ParamField body="negative_prompt" type="string">
  生成動画で避けたい内容を説明します。
</ParamField>

<ParamField body="reference_images" type="object[]" required={true}>
  動画生成をガイドするための1〜3枚の参考画像。各要素には画像URLまたはBase64エンコードデータ、および参照タイプが含まれます。

  配列の長さ：1 - 3
</ParamField>

<ParamField body="person_generation" type="string" default="allow_adult">
  成人人物の生成を許可するかどうか。allow\_adult：成人の生成を許可します；dont\_allow：人物の生成を許可しません。

  指定可能な値：`allow_adult`, `dont_allow`
</ParamField>

## レスポンス情報

<ResponseField name="task_id" type="string" required={false}>
  task\_id を使用して [タスク結果照会 API](/ja/docs/models/reference-get-async-task-result) にリクエストし、生成された出力を取得します。
</ResponseField>