> ## 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.

# Gemini 3.1 Flash 画像編集

Gemini 3.1 Flash モデルを使用し、自然言語プロンプトで画像を編集します。入力として URL および Base64 エンコードされた画像に対応し、最大 14 枚の参照画像を渡せます。

## リクエストヘッダー

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

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

## リクエストボディ

<ParamField body="size" type="string" default="1K">
  出力画像のピクセルサイズ。0.5K（約512px）、1K（約1024px）、2K（約2048px）、4K（約4096px）。デフォルトは 1K

  選択可能な値：`0.5K`, `1K`, `2K`, `4K`
</ParamField>

<ParamField body="google" type="object">
  Google 検索オプション

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="web_search" type="boolean" default={false}>
      Google ウェブ検索を有効にし、現実世界の情報に基づいてより正確な画像を生成します。
    </ParamField>

    <ParamField body="image_search" type="boolean" default={false}>
      Google 画像検索を有効にし、実際の画像を生成時の視覚的な参照として使用します。
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  期待する画像編集効果を説明するテキストプロンプト
</ParamField>

<ParamField body="image_urls" type="string[]">
  編集に使用する入力画像 URL のリスト。最大 14 枚の参照画像に対応

  配列の長さ：0 - 14
</ParamField>

<ParamField body="aspect_ratio" type="string">
  出力画像のアスペクト比。標準比率および新しい超ワイド/超縦長比率（1:4、4:1、1:8、8:1）に対応

  選択可能な値：`1:1`, `1:4`, `1:8`, `2:3`, `3:2`, `3:4`, `4:1`, `4:3`, `4:5`, `5:4`, `8:1`, `9:16`, `16:9`, `21:9`
</ParamField>

<ParamField body="image_base64s" type="string[]">
  編集に使用する Base64 エンコード画像のリスト。image\_urls と image\_base64s の合計数は 14 枚以下です

  配列の長さ：0 - 14
</ParamField>

<ParamField body="output_format" type="string" default="image/png">
  出力画像の MIME タイプ。対応形式：image/png、image/jpeg。デフォルトは image/png

  選択可能な値：`image/png`, `image/jpeg`
</ParamField>

## レスポンス情報

<ResponseField name="image_urls" type="string[]" required={true}>
  編集後の画像 URL のリスト
</ResponseField>

<ResponseField name="grounding_metadata" type="object" required={false}>
  モデルの grounding メタデータ。Google サーバー側ツール（検索など）が呼び出された場合に返されます。注意：ツール呼び出しは Google に依存します。パラメータでツールを有効にしても、必ずしも 100% ツール呼び出しが発生するとは限りません。
</ResponseField>
