メインコンテンツへスキップ
POST
Image Editing: Edit an existing image with text instructions
右側のインタラクティブなプレイグラウンドでは、ドロップダウンからパラメーターを選択できます。Authorization フィールドにAPI Key(形式: Bearer sk-xxx)を入力すると、ワンクリックでテストリクエストを送信できます。
対象範囲: このページでは画像編集を扱います。編集指示とともに入力画像(base64エンコード)を指定する必要があります。テキストのみから新しい画像を生成するには、テキストから画像へのエンドポイントを使用してください。
🖥️ ブラウザーのプレイグラウンドに関する制限(重要)このエンドポイントは、レスポンスでbase64エンコードされた画像(inlineData.data。通常は数MB)を返します。ブラウザーの描画制限により、レスポンスの受信後、右側のプレイグラウンドに请求时发生错误: unable to complete requestが表示される場合があります。リクエスト自体は成功しています。ブラウザーで長いbase64文字列を描画できないだけです。推奨ワークフロー(初心者向け):
  • 以下のPython / Node.js / cURLのサンプルをコピーして、ローカル環境で実行してください。コードがレスポンスを自動的にbase64.b64decodeし、画像をファイルに書き込みます。
  • ブラウザー内のプレイグラウンドを使う必要がある場合は、ごく小さな参照画像(< 50KB)を使用し、imageSizeを最小のティア(例: 1K)に設定してください。
⚠️ parts配列の構造(重要 — 複数画像の編集を行う場合は必ずお読みください)各partには**textまたはinlineDataのいずれか一方のみ**を指定してください。両方を指定することはできません。これはGoogleの公式gemini-3-pro-imageの仕様に準拠しています。正しい例: テキストパート(指示)を1つ + inlineDataパートをN個(画像ごとに1つ):
誤った例(各パートにtextとinlineDataの両方が含まれており、動作は未定義になります):
inlineData.dataフィールドについてこのエンドポイントではJSON形式(multipartファイルアップロードではありません)を使用するため、プレイグラウンドからローカルファイルを直接選択することはできません。まず画像をBase64文字列に変換し、それをdata入力欄に貼り付ける必要があります。1行のコマンド: 変換してクリップボードにコピー:
実行後、Cmd+V / Ctrl+Vでプレイグラウンドのdataフィールドに貼り付けるだけです。また、mimeTypeを対応するimage/jpegまたはimage/pngに設定してください。推奨: 長いbase64文字列によるブラウザーの動作遅延を避けるため、テストには小さな画像(200KB未満)を使用してください。画像編集のテストを頻繁に行う場合は、以下のコード例を使ってローカルで実行してください。

コード例

Python

Node.js

cURL

複数画像の編集

複数の入力画像を結合または比較する場合は、単一のtextパート(指示)の後に、複数のinlineDataパート(画像ごとに1つ)を指定します。

Python(複数画像)

cURL(複数画像、Googleの公式フォーマットに準拠)

パラメータ早見表

Nano Banana Pro はマルチ画像編集をサポートします。複数の画像を編集指示とともに入力でき、マルチ画像合成やスタイル転送のような高度な機能に対応しています。

承認

Authorization
string
header
必須

API Key from APIYI Console

ボディ

application/json
contents
object[]
必須

Content array with edit instructions and image to edit

generationConfig
object
必須

レスポンス

Image edited successfully

candidates
object[]

Generated results array

usageMetadata
object