メインコンテンツへスキップ
POST
/
v3
/
gemini-3.1-flash-image-edit
Gemini 3.1 Flash 画像編集
curl --request POST \
  --url https://api.highwayapi.ai/v3/gemini-3.1-flash-image-edit \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "size": "<string>",
  "google": {
    "web_search": true,
    "image_search": true
  },
  "prompt": "<string>",
  "image_urls": [
    {}
  ],
  "aspect_ratio": "<string>",
  "image_base64s": [
    {}
  ],
  "output_format": "<string>"
}
'
{
  "image_urls": [
    {}
  ],
  "grounding_metadata": {}
}
Gemini 3.1 Flash モデルを使用し、自然言語プロンプトで画像を編集します。入力として URL および Base64 エンコードされた画像に対応し、最大 14 枚の参照画像を渡せます。

リクエストヘッダー

Content-Type
string
必須
列挙値: application/json
Authorization
string
必須
Bearer 認証形式: Bearer {{API キー}}。

リクエストボディ

size
string
デフォルト:"1K"
出力画像のピクセルサイズ。0.5K(約512px)、1K(約1024px)、2K(約2048px)、4K(約4096px)。デフォルトは 1K選択可能な値:0.5K, 1K, 2K, 4K
google
object
Google 検索オプション
prompt
string
必須
期待する画像編集効果を説明するテキストプロンプト
image_urls
array
編集に使用する入力画像 URL のリスト。最大 14 枚の参照画像に対応配列の長さ:0 - 14
aspect_ratio
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
image_base64s
array
編集に使用する Base64 エンコード画像のリスト。image_urls と image_base64s の合計数は 14 枚以下です配列の長さ:0 - 14
output_format
string
デフォルト:"image/png"
出力画像の MIME タイプ。対応形式:image/png、image/jpeg。デフォルトは image/png選択可能な値:image/png, image/jpeg

レスポンス情報

image_urls
array
必須
編集後の画像 URL のリスト
grounding_metadata
object
モデルの grounding メタデータ。Google サーバー側ツール(検索など)が呼び出された場合に返されます。注意:ツール呼び出しは Google に依存します。パラメータでツールを有効にしても、必ずしも 100% ツール呼び出しが発生するとは限りません。