画像を編集
画像から画像 / 画像編集:GPT Image(mask 対応)、Seedream、および「Gemini 特価版(AI Studio / Vertex)」グループの Gemini。
/v1/images/edits参照画像をもとに生成、または部分編集します。リクエスト形式は multipart/form-data を推奨します(ローカルファイル、参照画像フィールドは image / image[] で繰り返し可)。JSON(参照画像は HTTP(S) URL または Data URL)も受け付け、どちらもフィールド名は同じです。右側の例は JSON です。multipart の書き方は画像生成ガイドを参照してください。
JSON での編集と非同期タスクでは output_compression、moderation、user、response_format は保持されません。「Gemini 公式ダイレクト(エンタープライズ)」グループにはこのエンドポイントがないため、画像を生成で参照画像を渡してください。
課金が発生した非ストリーミングのレスポンスは、このリクエストの実際の課金額を返します。レスポンスヘッダー X-HopBase-Cost / X-HopBase-Cost-USD / X-HopBase-Currency と、レスポンスボディのルート usage 内の cost / cost_usd / currency です(usage の既存フィールドはそのまま)。cost_usd は残高から実際に差し引かれた米ドル額、cost は同じ課金額の人民元額で、currency は常に CNY です。ストリーミング(SSE)では返さないため、コンソールの「利用履歴」で確認してください。課金されないレスポンス(エラーなど)には付きません。詳しくはアカウント API · 課金を参照してください。
ヘッダー
Bearer sk-…:コンソールの「API キー」で作成したキー。キーのグループにリクエストするモデルが含まれている必要があります
respond-async:GPT Image / Gemini は即座に 202 Accepted、task_id、status_url を返すので、GET /v1/images/tasks?task_id=… でポーリングします。2K / 4K の大きな画像を生成する場合に推奨します。Seedream はこのヘッダーを無視し、通常どおり同期で返します
取りうる値respond-async
リクエストボディJSON
data[].b64_json から読み取ります。 参照画像は最大 16 枚。まず現在のキーの GET /v1/models にこの ID が含まれていることを確認してください
生成または編集の指示。空の場合は 400 prompt must not be empty。ゲートウェイでは長さを制限せず、上限は公式上限に従います
制限前後の空白を除いて空にはできません。空の場合は 400「prompt must not be empty」長さ1–32000 文字
例:1024x1024、2048x2048、3840x2160。不正な値は生成前に 400 を返し、課金されません。1K / 2K / 4K は受け付けません
制限auto または 幅x高さ:辺の長さは 16 の倍数、1 辺 3840 以下、長辺と短辺の比 3:1 以下、総ピクセル数 655360–8294400
レベルが高いほど出力トークンが増え、費用も高くなります。1024x1024 の実測では low 約 200、high 約 1,760、xhigh 約 3,120、max 約 7,020 出力トークンです
取りうる値autolowmediumhigh
制限ゲートウェイでは検証せず、そのまま転送。レベルが高いほど出力トークンが増えます
一部のグループは 1 のみ対応で、それより大きい値は 400 を返します。0 以下は 1 として扱います
範囲1–10デフォルト1
transparent は png または webp と組み合わせる必要があります。2.0 の透明背景はプレビュー機能です
取りうる値autoopaquetransparent
b64_json をデコードした後の形式を決めます
取りうる値pngjpegwebp
jpeg / webp のみ。同期の generations JSON と multipart の編集でのみ保持されます
範囲0–100デフォルト100
コンテンツの安全性チェックを無効にするものではありません
取りうる値autolow
エンドユーザー識別用の文字列。HopBase のアカウント ID ではなく、課金の帰属も変わりません
何を指定しても b64_json で返され、url でダウンロードリンクは取得できません。省略してください
true にすると HopBase Images SSE になります(その間キープアライブを送信し、最後の data: イベントだけが Images JSON で、[DONE] で終わります)。OpenAI ネイティブの画像ごとのプレビューイベントではありません。SDK では false のままにしてください
制限true で HopBase Images SSE を返します。SDK では false のままにしてくださいデフォルトfalse
互換用フィールド。GPT Image 2 は既定で参照画像を高忠実度で処理するため、省略してください
取りうる値lowhigh
multipart のファイル(image / image[])、または JSON の HTTP(S) URL / Data URL 文字列、文字列配列。images は読み取らず、生の base64 や file_id は受け付けません。転送前に圧縮されることがあります
制限1–16 枚(公式上限)。リモート URL は 1 枚 26214400 バイト以下で、image/* を返す必要があります。image のみ読み取り、images は読み取りません
透明な領域が編集対象です。ゲートウェイは mask を 1 枚目の参照画像のサイズに合わせて拡縮します。マスク外がピクセル単位で変わらないことは保証されません
制限アルファチャンネル付きの PNG。透明な領域が編集対象です
- transparent には png または webp が必要です
- output_compression は jpeg / webp でのみ有効です
まず現在のキーの GET /v1/models にこの ID が含まれていることを確認してください
生成または編集の指示。空の場合は 400 prompt must not be empty。ゲートウェイでは長さを制限せず、上限は公式上限に従います
制限前後の空白を除いて空にはできません。空の場合は 400「prompt must not be empty」長さ1–32000 文字
例:1024x1024、2048x2048、3840x2160。不正な値は生成前に 400 を返し、課金されません。1K / 2K / 4K は受け付けません
制限auto または 幅x高さ:辺の長さは 16 の倍数、1 辺 3840 以下、長辺と短辺の比 3:1 以下、総ピクセル数 655360–8294400
レベルが高いほど出力トークンが増え、費用も高くなります。1024x1024 の実測では low 約 200、high 約 1,760、xhigh 約 3,120、max 約 7,020 出力トークンです
取りうる値autolowmediumhighxhighmax
制限ゲートウェイでは検証せず、そのまま転送。レベルが高いほど出力トークンが増えます
一部のグループは 1 のみ対応で、それより大きい値は 400 を返します。0 以下は 1 として扱います
範囲1–10デフォルト1
transparent は png または webp と組み合わせる必要があります。2.0 の透明背景はプレビュー機能です
取りうる値autoopaquetransparent
b64_json をデコードした後の形式を決めます
取りうる値pngjpegwebp
jpeg / webp のみ。同期の generations JSON と multipart の編集でのみ保持されます
範囲0–100デフォルト100
コンテンツの安全性チェックを無効にするものではありません
取りうる値autolow
エンドユーザー識別用の文字列。HopBase のアカウント ID ではなく、課金の帰属も変わりません
何を指定しても b64_json で返され、url でダウンロードリンクは取得できません。省略してください
true にすると HopBase Images SSE になります(その間キープアライブを送信し、最後の data: イベントだけが Images JSON で、[DONE] で終わります)。OpenAI ネイティブの画像ごとのプレビューイベントではありません。SDK では false のままにしてください
制限true で HopBase Images SSE を返します。SDK では false のままにしてくださいデフォルトfalse
互換用フィールド。GPT Image 2 は既定で参照画像を高忠実度で処理するため、省略してください
取りうる値lowhigh
multipart のファイル(image / image[])、または JSON の HTTP(S) URL / Data URL 文字列、文字列配列。images は読み取らず、生の base64 や file_id は受け付けません。転送前に圧縮されることがあります
制限1–16 枚(公式上限)。リモート URL は 1 枚 26214400 バイト以下で、image/* を返す必要があります。image のみ読み取り、images は読み取りません
透明な領域が編集対象です。ゲートウェイは mask を 1 枚目の参照画像のサイズに合わせて拡縮します。マスク外がピクセル単位で変わらないことは保証されません
制限アルファチャンネル付きの PNG。透明な領域が編集対象です
- transparent には png または webp が必要です
- output_compression は jpeg / webp でのみ有効です
まず現在のキーの GET /v1/models にこの ID が含まれていることを確認してください
生成または編集の指示。空の場合は 400 prompt must not be empty。ゲートウェイでは長さを制限せず、上限は公式上限に従います
制限前後の空白を除いて空にはできません。空の場合は 400「prompt must not be empty」長さ1–32000 文字
例:1024x1024、2048x2048、3840x2160。不正な値は生成前に 400 を返し、課金されません。1K / 2K / 4K は受け付けません
制限auto または 幅x高さ:辺の長さは 16 の倍数、1 辺 3840 以下、長辺と短辺の比 3:1 以下、総ピクセル数 655360–8294400
レベルが高いほど出力トークンが増え、費用も高くなります。1024x1024 の実測では low 約 200、high 約 1,760、xhigh 約 3,120、max 約 7,020 出力トークンです
取りうる値autolowmediumhighxhighmax
制限ゲートウェイでは検証せず、そのまま転送。レベルが高いほど出力トークンが増えます
一部のグループは 1 のみ対応で、それより大きい値は 400 を返します。0 以下は 1 として扱います
範囲1–10デフォルト1
transparent は png または webp と組み合わせる必要があります。2.0 の透明背景はプレビュー機能です
取りうる値autoopaquetransparent
b64_json をデコードした後の形式を決めます
取りうる値pngjpegwebp
jpeg / webp のみ。同期の generations JSON と multipart の編集でのみ保持されます
範囲0–100デフォルト100
コンテンツの安全性チェックを無効にするものではありません
取りうる値autolow
エンドユーザー識別用の文字列。HopBase のアカウント ID ではなく、課金の帰属も変わりません
何を指定しても b64_json で返され、url でダウンロードリンクは取得できません。省略してください
true にすると HopBase Images SSE になります(その間キープアライブを送信し、最後の data: イベントだけが Images JSON で、[DONE] で終わります)。OpenAI ネイティブの画像ごとのプレビューイベントではありません。SDK では false のままにしてください
制限true で HopBase Images SSE を返します。SDK では false のままにしてくださいデフォルトfalse
互換用フィールド。GPT Image 2 は既定で参照画像を高忠実度で処理するため、省略してください
取りうる値lowhigh
multipart のファイル(image / image[])、または JSON の HTTP(S) URL / Data URL 文字列、文字列配列。images は読み取らず、生の base64 や file_id は受け付けません。転送前に圧縮されることがあります
制限1–16 枚(公式上限)。リモート URL は 1 枚 26214400 バイト以下で、image/* を返す必要があります。image のみ読み取り、images は読み取りません
透明な領域が編集対象です。ゲートウェイは mask を 1 枚目の参照画像のサイズに合わせて拡縮します。マスク外がピクセル単位で変わらないことは保証されません
制限アルファチャンネル付きの PNG。透明な領域が編集対象です
- transparent には png または webp が必要です
- output_compression は jpeg / webp でのみ有効です
まず現在のキーの GET /v1/models にこの ID が含まれていることを確認してください
生成または編集の指示。空の場合は 400 prompt must not be empty。ゲートウェイでは長さを制限せず、上限は公式上限に従います
制限前後の空白を除いて空にはできません。空の場合は 400「prompt must not be empty」長さ1–32000 文字
例:1024x1024、2048x2048、3840x2160。不正な値は生成前に 400 を返し、課金されません。1K / 2K / 4K は受け付けません
制限auto または 幅x高さ:辺の長さは 16 の倍数、1 辺 3840 以下、長辺と短辺の比 3:1 以下、総ピクセル数 655360–8294400
レベルが高いほど出力トークンが増え、費用も高くなります。1024x1024 の実測では low 約 200、high 約 1,760、xhigh 約 3,120、max 約 7,020 出力トークンです
取りうる値autolowmediumhighxhighmax
制限ゲートウェイでは検証せず、そのまま転送。レベルが高いほど出力トークンが増えます
一部のグループは 1 のみ対応で、それより大きい値は 400 を返します。0 以下は 1 として扱います
範囲1–10デフォルト1
transparent は png または webp と組み合わせる必要があります。2.0 の透明背景はプレビュー機能です
取りうる値autoopaquetransparent
b64_json をデコードした後の形式を決めます
取りうる値pngjpegwebpsvggif
jpeg / webp のみ。同期の generations JSON と multipart の編集でのみ保持されます
範囲0–100デフォルト100
コンテンツの安全性チェックを無効にするものではありません
取りうる値autolow
エンドユーザー識別用の文字列。HopBase のアカウント ID ではなく、課金の帰属も変わりません
何を指定しても b64_json で返され、url でダウンロードリンクは取得できません。省略してください
true にすると HopBase Images SSE になります(その間キープアライブを送信し、最後の data: イベントだけが Images JSON で、[DONE] で終わります)。OpenAI ネイティブの画像ごとのプレビューイベントではありません。SDK では false のままにしてください
制限true で HopBase Images SSE を返します。SDK では false のままにしてくださいデフォルトfalse
互換用フィールド。GPT Image 2 は既定で参照画像を高忠実度で処理するため、省略してください
取りうる値lowhigh
描画前にモデルがどれだけ計画するか。追加料金なし。それ以外の値はゲートウェイが 400 を返します
取りうる値lowmediumhigh
デフォルト"high"
output_format=gif のみ:フレーム数。gif の size は 1 フレームのサイズで、全フレームは 1 辺 3840 以下の 1 枚のシートに並べられるため、auto か 512x512 のような小さいサイズを使ってください
範囲2–16デフォルト9
output_format=gif のみ:1 フレームの表示時間(ミリ秒)
範囲20–2000デフォルト200
multipart のファイル(image / image[])、または JSON の HTTP(S) URL / Data URL 文字列、文字列配列。images は読み取らず、生の base64 や file_id は受け付けません。転送前に圧縮されることがあります
制限1–16 枚(公式上限)。リモート URL は 1 枚 26214400 バイト以下で、image/* を返す必要があります。image のみ読み取り、images は読み取りません
透明な領域が編集対象です。ゲートウェイは mask を 1 枚目の参照画像のサイズに合わせて拡縮します。マスク外がピクセル単位で変わらないことは保証されません
制限アルファチャンネル付きの PNG。透明な領域が編集対象です
GPT Image 2.6 のみ:丸・矢印・メモを描いた透明 PNG のオーバーレイで、最初の入力画像と同じサイズ。モデルは注釈どおりに編集します。mask と併用不可
- transparent には png または webp が必要です
- output_compression は jpeg / webp でのみ有効です
- output_format=svg のときは n は 1 のみ
- markup は mask と併用できません
まず現在のキーの GET /v1/models にこの ID が含まれていることを確認してください
生成または編集の指示。空の場合は 400 prompt must not be empty。ゲートウェイでは長さを制限せず、上限は公式上限に従います
制限前後の空白を除いて空にはできません。空の場合は 400「prompt must not be empty」長さ1–32000 文字
例:1024x1024、2048x2048、3840x2160。不正な値は生成前に 400 を返し、課金されません。1K / 2K / 4K は受け付けません
制限auto または 幅x高さ:辺の長さは 16 の倍数、1 辺 3840 以下、長辺と短辺の比 3:1 以下、総ピクセル数 655360–8294400
レベルが高いほど出力トークンが増え、費用も高くなります。1024x1024 の実測では low 約 200、high 約 1,760、xhigh 約 3,120、max 約 7,020 出力トークンです
取りうる値autolowmediumhighxhighmax
制限ゲートウェイでは検証せず、そのまま転送。レベルが高いほど出力トークンが増えます
一部のグループは 1 のみ対応で、それより大きい値は 400 を返します。0 以下は 1 として扱います
範囲1–10デフォルト1
transparent は png または webp と組み合わせる必要があります。2.0 の透明背景はプレビュー機能です
取りうる値autoopaquetransparent
b64_json をデコードした後の形式を決めます
取りうる値pngjpegwebpsvggif
jpeg / webp のみ。同期の generations JSON と multipart の編集でのみ保持されます
範囲0–100デフォルト100
コンテンツの安全性チェックを無効にするものではありません
取りうる値autolow
エンドユーザー識別用の文字列。HopBase のアカウント ID ではなく、課金の帰属も変わりません
何を指定しても b64_json で返され、url でダウンロードリンクは取得できません。省略してください
true にすると HopBase Images SSE になります(その間キープアライブを送信し、最後の data: イベントだけが Images JSON で、[DONE] で終わります)。OpenAI ネイティブの画像ごとのプレビューイベントではありません。SDK では false のままにしてください
制限true で HopBase Images SSE を返します。SDK では false のままにしてくださいデフォルトfalse
互換用フィールド。GPT Image 2 は既定で参照画像を高忠実度で処理するため、省略してください
取りうる値lowhigh
描画前にモデルがどれだけ計画するか。追加料金なし。それ以外の値はゲートウェイが 400 を返します
取りうる値lowmediumhigh
デフォルト"high"
output_format=gif のみ:フレーム数。gif の size は 1 フレームのサイズで、全フレームは 1 辺 3840 以下の 1 枚のシートに並べられるため、auto か 512x512 のような小さいサイズを使ってください
範囲2–16デフォルト9
output_format=gif のみ:1 フレームの表示時間(ミリ秒)
範囲20–2000デフォルト200
multipart のファイル(image / image[])、または JSON の HTTP(S) URL / Data URL 文字列、文字列配列。images は読み取らず、生の base64 や file_id は受け付けません。転送前に圧縮されることがあります
制限1–16 枚(公式上限)。リモート URL は 1 枚 26214400 バイト以下で、image/* を返す必要があります。image のみ読み取り、images は読み取りません
透明な領域が編集対象です。ゲートウェイは mask を 1 枚目の参照画像のサイズに合わせて拡縮します。マスク外がピクセル単位で変わらないことは保証されません
制限アルファチャンネル付きの PNG。透明な領域が編集対象です
GPT Image 2.6 のみ:丸・矢印・メモを描いた透明 PNG のオーバーレイで、最初の入力画像と同じサイズ。モデルは注釈どおりに編集します。mask と併用不可
- transparent には png または webp が必要です
- output_compression は jpeg / webp でのみ有効です
- output_format=svg のときは n は 1 のみ
- markup は mask と併用できません
現在のキーの GET /v1/models の返り値が基準です
モデルが拒否した、またはテキストのみを返した場合は 400(メッセージにそのテキストを引用)または 502 を返します。プロンプトを書き換えてください
制限前後の空白を除いて空にはできません。空の場合は 400「prompt must not be empty」長さ≥ 1 文字
並列で生成します。全か無か:いずれか 1 枚でも失敗するとリクエスト全体が失敗し、課金されません
制限出力解像度ごとの上限:1K ≤ 10、2K ≤ 5範囲1–10デフォルト1
トップレベルのフラットな書き方で、google.image_config.image_size と等価です。size から導かれるレベルを上書きします
取りうる値1K2K
デフォルト"1K"
トップレベルのフラットな書き方で、google.image_config.aspect_ratio と等価です。size より優先されます
取りうる値1:12:33:23:44:34:55:49:1616:921:9
デフォルト"1:1"
幅x高さ は比率を理由に拒否されることはありません。最も近い公式の比率に対応付けられ、レベルは長辺から導かれ、モデルの最高レベルまで黙って引き下げられます。モデルのレベルを超える 1K / 2K / 4K を明示すると 400 を返します。image_size も同時に指定した場合はそちらが優先されます
取りうる値1K2K
制限auto、任意の比率の 幅x高さ(最も近い公式の比率に対応付け、解像度は長辺から導き、モデルの最高解像度まで黙って引き下げ)、またはモデルの解像度
SDK では extra_body.google.image_config とも書けます。3 つの書き方は等価です
取りうる値1:12:33:23:44:34:55:49:1616:921:9
取りうる値1K2K
参照画像。generations のリクエストボディに入れるだけで使えます。両方指定した場合は images が優先されます。「Gemini 公式ダイレクト(エンタープライズ)」は 1 枚あたりデコード後 20 MiB 以下で、/v1/images/edits はありません
制限参照画像:文字列または文字列の配列、最大 14 枚
image と同じ。両方指定した場合は images が優先されます
制限参照画像:文字列または文字列の配列、最大 14 枚
非対応:mask を指定すると 400 を返します。部分的な修正はプロンプトで領域を説明してください
transparent には非対応(400 を返します)
指定不可"transparent"
非対応。省略するか false を指定してください
指定不可true
- 2K 出力は 1 回あたり最大 5 枚(レスポンスサイズの上限)
現在のキーの GET /v1/models の返り値が基準です
モデルが拒否した、またはテキストのみを返した場合は 400(メッセージにそのテキストを引用)または 502 を返します。プロンプトを書き換えてください
制限前後の空白を除いて空にはできません。空の場合は 400「prompt must not be empty」長さ≥ 1 文字
並列で生成します。全か無か:いずれか 1 枚でも失敗するとリクエスト全体が失敗し、課金されません
制限出力解像度ごとの上限:1K ≤ 10、2K ≤ 5範囲1–10デフォルト1
トップレベルのフラットな書き方で、google.image_config.image_size と等価です。size から導かれるレベルを上書きします
取りうる値1K2K
デフォルト"1K"
トップレベルのフラットな書き方で、google.image_config.aspect_ratio と等価です。size より優先されます
取りうる値1:12:33:23:44:34:55:49:1616:921:9
デフォルト"1:1"
幅x高さ は比率を理由に拒否されることはありません。最も近い公式の比率に対応付けられ、レベルは長辺から導かれ、モデルの最高レベルまで黙って引き下げられます。モデルのレベルを超える 1K / 2K / 4K を明示すると 400 を返します。image_size も同時に指定した場合はそちらが優先されます
取りうる値1K2K
制限auto、任意の比率の 幅x高さ(最も近い公式の比率に対応付け、解像度は長辺から導き、モデルの最高解像度まで黙って引き下げ)、またはモデルの解像度
SDK では extra_body.google.image_config とも書けます。3 つの書き方は等価です
取りうる値1:12:33:23:44:34:55:49:1616:921:9
取りうる値1K2K
参照画像。generations のリクエストボディに入れるだけで使えます。両方指定した場合は images が優先されます。「Gemini 公式ダイレクト(エンタープライズ)」は 1 枚あたりデコード後 20 MiB 以下で、/v1/images/edits はありません
制限参照画像:文字列または文字列の配列、最大 14 枚
image と同じ。両方指定した場合は images が優先されます
制限参照画像:文字列または文字列の配列、最大 14 枚
非対応:mask を指定すると 400 を返します。部分的な修正はプロンプトで領域を説明してください
transparent には非対応(400 を返します)
指定不可"transparent"
非対応。省略するか false を指定してください
指定不可true
- 2K 出力は 1 回あたり最大 5 枚(レスポンスサイズの上限)
現在のキーの GET /v1/models の返り値が基準です
モデルが拒否した、またはテキストのみを返した場合は 400(メッセージにそのテキストを引用)または 502 を返します。プロンプトを書き換えてください
制限前後の空白を除いて空にはできません。空の場合は 400「prompt must not be empty」長さ≥ 1 文字
並列で生成します。全か無か:いずれか 1 枚でも失敗するとリクエスト全体が失敗し、課金されません
制限出力解像度ごとの上限:1K ≤ 10、2K ≤ 5、4K ≤ 2範囲1–10デフォルト1
トップレベルのフラットな書き方で、google.image_config.image_size と等価です。size から導かれるレベルを上書きします
取りうる値1K2K4K
デフォルト"1K"
トップレベルのフラットな書き方で、google.image_config.aspect_ratio と等価です。size より優先されます
取りうる値1:12:33:23:44:34:55:49:1616:921:9
デフォルト"1:1"
幅x高さ は比率を理由に拒否されることはありません。最も近い公式の比率に対応付けられ、レベルは長辺から導かれ、モデルの最高レベルまで黙って引き下げられます。モデルのレベルを超える 1K / 2K / 4K を明示すると 400 を返します。image_size も同時に指定した場合はそちらが優先されます
取りうる値1K2K4K
制限auto、任意の比率の 幅x高さ(最も近い公式の比率に対応付け、解像度は長辺から導き、モデルの最高解像度まで黙って引き下げ)、またはモデルの解像度
SDK では extra_body.google.image_config とも書けます。3 つの書き方は等価です
取りうる値1:12:33:23:44:34:55:49:1616:921:9
取りうる値1K2K4K
参照画像。generations のリクエストボディに入れるだけで使えます。両方指定した場合は images が優先されます。「Gemini 公式ダイレクト(エンタープライズ)」は 1 枚あたりデコード後 20 MiB 以下で、/v1/images/edits はありません
制限参照画像:文字列または文字列の配列、最大 14 枚
image と同じ。両方指定した場合は images が優先されます
制限参照画像:文字列または文字列の配列、最大 14 枚
非対応:mask を指定すると 400 を返します。部分的な修正はプロンプトで領域を説明してください
transparent には非対応(400 を返します)
指定不可"transparent"
非対応。省略するか false を指定してください
指定不可true
- 2K 出力は 1 回あたり最大 5 枚(レスポンスサイズの上限)
- 4K 出力は 1 回あたり最大 2 枚(レスポンスサイズの上限)
現在のキーの GET /v1/models の返り値が基準です
モデルが拒否した、またはテキストのみを返した場合は 400(メッセージにそのテキストを引用)または 502 を返します。プロンプトを書き換えてください
制限前後の空白を除いて空にはできません。空の場合は 400「prompt must not be empty」長さ≥ 1 文字
並列で生成します。全か無か:いずれか 1 枚でも失敗するとリクエスト全体が失敗し、課金されません
制限出力解像度ごとの上限:1K ≤ 10、2K ≤ 5、4K ≤ 2範囲1–10デフォルト1
トップレベルのフラットな書き方で、google.image_config.image_size と等価です。size から導かれるレベルを上書きします
取りうる値1K2K4K
デフォルト"1K"
トップレベルのフラットな書き方で、google.image_config.aspect_ratio と等価です。size より優先されます
取りうる値1:12:33:23:44:34:55:49:1616:921:9
デフォルト"1:1"
幅x高さ は比率を理由に拒否されることはありません。最も近い公式の比率に対応付けられ、レベルは長辺から導かれ、モデルの最高レベルまで黙って引き下げられます。モデルのレベルを超える 1K / 2K / 4K を明示すると 400 を返します。image_size も同時に指定した場合はそちらが優先されます
取りうる値1K2K4K
制限auto、任意の比率の 幅x高さ(最も近い公式の比率に対応付け、解像度は長辺から導き、モデルの最高解像度まで黙って引き下げ)、またはモデルの解像度
SDK では extra_body.google.image_config とも書けます。3 つの書き方は等価です
取りうる値1:12:33:23:44:34:55:49:1616:921:9
取りうる値1K2K4K
参照画像。generations のリクエストボディに入れるだけで使えます。両方指定した場合は images が優先されます。「Gemini 公式ダイレクト(エンタープライズ)」は 1 枚あたりデコード後 20 MiB 以下で、/v1/images/edits はありません
制限参照画像:文字列または文字列の配列、最大 14 枚
image と同じ。両方指定した場合は images が優先されます
制限参照画像:文字列または文字列の配列、最大 14 枚
非対応:mask を指定すると 400 を返します。部分的な修正はプロンプトで領域を説明してください
transparent には非対応(400 を返します)
指定不可"transparent"
非対応。省略するか false を指定してください
指定不可true
- 2K 出力は 1 回あたり最大 5 枚(レスポンスサイズの上限)
- 4K 出力は 1 回あたり最大 2 枚(レスポンスサイズの上限)
現在のキーの GET /v1/models の返り値が基準です
モデルが拒否した、またはテキストのみを返した場合は 400(メッセージにそのテキストを引用)または 502 を返します。プロンプトを書き換えてください
制限前後の空白を除いて空にはできません。空の場合は 400「prompt must not be empty」長さ≥ 1 文字
並列で生成します。全か無か:いずれか 1 枚でも失敗するとリクエスト全体が失敗し、課金されません
制限出力解像度ごとの上限:1K ≤ 10範囲1–10デフォルト1
トップレベルのフラットな書き方で、google.image_config.image_size と等価です。size から導かれるレベルを上書きします
取りうる値1K
デフォルト"1K"
トップレベルのフラットな書き方で、google.image_config.aspect_ratio と等価です。size より優先されます
取りうる値1:12:33:23:44:34:55:49:1616:921:9
デフォルト"1:1"
幅x高さ は比率を理由に拒否されることはありません。最も近い公式の比率に対応付けられ、レベルは長辺から導かれ、モデルの最高レベルまで黙って引き下げられます。モデルのレベルを超える 1K / 2K / 4K を明示すると 400 を返します。image_size も同時に指定した場合はそちらが優先されます
取りうる値1K
制限auto、任意の比率の 幅x高さ(最も近い公式の比率に対応付け、解像度は長辺から導き、モデルの最高解像度まで黙って引き下げ)、またはモデルの解像度
SDK では extra_body.google.image_config とも書けます。3 つの書き方は等価です
取りうる値1:12:33:23:44:34:55:49:1616:921:9
取りうる値1K
参照画像。generations のリクエストボディに入れるだけで使えます。両方指定した場合は images が優先されます。「Gemini 公式ダイレクト(エンタープライズ)」は 1 枚あたりデコード後 20 MiB 以下で、/v1/images/edits はありません
制限参照画像:文字列または文字列の配列、最大 14 枚
image と同じ。両方指定した場合は images が優先されます
制限参照画像:文字列または文字列の配列、最大 14 枚
非対応:mask を指定すると 400 を返します。部分的な修正はプロンプトで領域を説明してください
transparent には非対応(400 を返します)
指定不可"transparent"
非対応。省略するか false を指定してください
指定不可true
現在のキーの GET /v1/models の返り値が基準です
モデルが拒否した、またはテキストのみを返した場合は 400(メッセージにそのテキストを引用)または 502 を返します。プロンプトを書き換えてください
制限前後の空白を除いて空にはできません。空の場合は 400「prompt must not be empty」長さ≥ 1 文字
並列で生成します。全か無か:いずれか 1 枚でも失敗するとリクエスト全体が失敗し、課金されません
制限出力解像度ごとの上限:1K ≤ 10範囲1–10デフォルト1
トップレベルのフラットな書き方で、google.image_config.image_size と等価です。size から導かれるレベルを上書きします
取りうる値1K
デフォルト"1K"
トップレベルのフラットな書き方で、google.image_config.aspect_ratio と等価です。size より優先されます
取りうる値1:12:33:23:44:34:55:49:1616:921:9
デフォルト"1:1"
幅x高さ は比率を理由に拒否されることはありません。最も近い公式の比率に対応付けられ、レベルは長辺から導かれ、モデルの最高レベルまで黙って引き下げられます。モデルのレベルを超える 1K / 2K / 4K を明示すると 400 を返します。image_size も同時に指定した場合はそちらが優先されます
取りうる値1K
制限auto、任意の比率の 幅x高さ(最も近い公式の比率に対応付け、解像度は長辺から導き、モデルの最高解像度まで黙って引き下げ)、またはモデルの解像度
SDK では extra_body.google.image_config とも書けます。3 つの書き方は等価です
取りうる値1:12:33:23:44:34:55:49:1616:921:9
取りうる値1K
参照画像。generations のリクエストボディに入れるだけで使えます。両方指定した場合は images が優先されます。「Gemini 公式ダイレクト(エンタープライズ)」は 1 枚あたりデコード後 20 MiB 以下で、/v1/images/edits はありません
制限参照画像:文字列または文字列の配列、最大 3 枚
image と同じ。両方指定した場合は images が優先されます
制限参照画像:文字列または文字列の配列、最大 3 枚
非対応:mask を指定すると 400 を返します。部分的な修正はプロンプトで領域を説明してください
transparent には非対応(400 を返します)
指定不可"transparent"
非対応。省略するか false を指定してください
指定不可true
現在のキーの GET /v1/models が返す完全な ID を使ってください
画像の内容、構図、スタイル、または編集指示。部分編集では座標、bbox、矢印、参照画像内の塗りつぶし領域を説明できます
制限前後の空白を除いて空にはできません。空の場合は 400「missing prompt」長さ≥ 1 文字
不正な値は生成前に 400 を返して有効な範囲を示し、課金されません
取りうる値1K1.5K2K
制限略記 1K / 1.5K / 2K、または 幅x高さ:総ピクセル数 921600–4624220、アスペクト比 1:16–16:1
その他の値(null を含む)は 400 を返します
制限only a single output is supported (n=1)デフォルト1
url は 24 時間有効な署名付きリンク、b64_json は data[].b64_json を返します。ストリーミングでない組画像では b64_json は使えません(stream: true が必要)
取りうる値urlb64_json
デフォルト"url"
4.5 は jpeg のみ
取りうる値pngjpeg
オブジェクトである必要があります
取りうる値standard
指定すると単一 / 複数画像からの画像生成または編集になります。/v1/images/edits では 1 枚以上が必須です。URL は送信時にダウンロードされず、サイズもチェックされません
制限参照画像(指定すると画像から画像 / 編集):最大 10 枚。Data URL は 1 枚 31457280 バイト以下。URL は送信時にダウンロードされません
seedream-5-0-pro のみ:true で PNG / JPEG の入力画像 1 枚を、ベース画像と最大 16 枚の透過 PNG レイヤーに分解します。このとき prompt は省略可、size は 1K / 1.5K / 2K / auto のみ(デフォルト auto)。1K で約 1.5 分かかるため、クライアントのタイムアウトは 5 分以上に設定してください。詳しくは Seedream · レイヤー分解
制限レイヤー分解には非対応:true を渡すと 400「model seedream-5-5 does not support layer_decomposition」指定不可true
本サービスのデフォルトは false(公式のデフォルトは true)。true で透かしを入れる
デフォルトfalse
seedream-5-5 / seedream-5-0-pro のみ:transparent は画像編集専用で、透過チャンネル付きの入力画像がちょうど 1 枚必要です(JPEG / BMP の Data URL は 400)。出力は PNG のため output_format: jpeg は不可。詳しくは Seedream · 透過背景
取りうる値opaquetransparent
デフォルト"opaque"
seedream-5-0-lite / seedream-4-5 のみ:auto で組画像を有効にし、モデルが prompt から枚数を決めます(max_images まで)。失敗した 1 枚は data[].error に入り課金されず、全枚失敗すると 400。ストリーミングでない組画像ではサーバーが最大約 280 秒待つため、stream: true を推奨します。詳しくは Seedream · 組画像
max_images は 1–15 の整数で、参照画像数 + max_images ≤ 15。multipart では sequential_image_generation_options[max_images] または max_images
seedream-5-0-lite / seedream-4-5 のみ:true で SSE を返し、1 枚ごとに image_generation.partial_succeeded / image_generation.partial_failed、最後に image_generation.completed と data: [DONE] を送ります。成功した枚数で課金され、ストリーミングのレスポンスには課金額のフィールドが付きません。詳しくは Seedream · ストリーミング
制限非対応:true を渡すと 400「model seedream-5-5 does not support stream」指定不可true
Web 検索は未対応で、渡すと 400
非対応:/v1/images/edits に mask を付けると 400 を返します(null でも同様)
- background transparent:透過チャンネル付きの入力画像ちょうど 1 枚、出力は png
現在のキーの GET /v1/models が返す完全な ID を使ってください
画像の内容、構図、スタイル、または編集指示。部分編集では座標、bbox、矢印、参照画像内の塗りつぶし領域を説明できます
制限前後の空白を除いて空にはできず、空なら 400「missing prompt」。layer_decomposition: true のときは省略可長さ≥ 1 文字
不正な値は生成前に 400 を返して有効な範囲を示し、課金されません
取りうる値1K1.5K2K
制限略記 1K / 1.5K / 2K、または 幅x高さ:総ピクセル数 921600–4624220、アスペクト比 1:16–16:1。レイヤー分解は 1K / 1.5K / 2K / auto のみ(デフォルト auto)
その他の値(null を含む)は 400 を返します
制限only a single output is supported (n=1)デフォルト1
url は 24 時間有効な署名付きリンク、b64_json は data[].b64_json を返します。ストリーミングでない組画像では b64_json は使えません(stream: true が必要)
取りうる値urlb64_json
デフォルト"url"
4.5 は jpeg のみ
取りうる値pngjpeg
オブジェクトである必要があります
取りうる値standardfast
指定すると単一 / 複数画像からの画像生成または編集になります。/v1/images/edits では 1 枚以上が必須です。URL は送信時にダウンロードされず、サイズもチェックされません
制限参照画像(指定すると画像から画像 / 編集):最大 10 枚。Data URL は 1 枚 31457280 バイト以下。URL は送信時にダウンロードされません
seedream-5-0-pro のみ:true で PNG / JPEG の入力画像 1 枚を、ベース画像と最大 16 枚の透過 PNG レイヤーに分解します。このとき prompt は省略可、size は 1K / 1.5K / 2K / auto のみ(デフォルト auto)。1K で約 1.5 分かかるため、クライアントのタイムアウトは 5 分以上に設定してください。詳しくは Seedream · レイヤー分解
制限レイヤー分解:入力画像 1 枚をベース画像と最大 16 枚の透過 PNG レイヤーに分解デフォルトfalse
本サービスのデフォルトは false(公式のデフォルトは true)。true で透かしを入れる
デフォルトfalse
seedream-5-5 / seedream-5-0-pro のみ:transparent は画像編集専用で、透過チャンネル付きの入力画像がちょうど 1 枚必要です(JPEG / BMP の Data URL は 400)。出力は PNG のため output_format: jpeg は不可。詳しくは Seedream · 透過背景
取りうる値opaquetransparent
デフォルト"opaque"
seedream-5-0-lite / seedream-4-5 のみ:auto で組画像を有効にし、モデルが prompt から枚数を決めます(max_images まで)。失敗した 1 枚は data[].error に入り課金されず、全枚失敗すると 400。ストリーミングでない組画像ではサーバーが最大約 280 秒待つため、stream: true を推奨します。詳しくは Seedream · 組画像
max_images は 1–15 の整数で、参照画像数 + max_images ≤ 15。multipart では sequential_image_generation_options[max_images] または max_images
seedream-5-0-lite / seedream-4-5 のみ:true で SSE を返し、1 枚ごとに image_generation.partial_succeeded / image_generation.partial_failed、最後に image_generation.completed と data: [DONE] を送ります。成功した枚数で課金され、ストリーミングのレスポンスには課金額のフィールドが付きません。詳しくは Seedream · ストリーミング
制限非対応:true を渡すと 400「model seedream-5-0-pro does not support stream」指定不可true
Web 検索は未対応で、渡すと 400
非対応:/v1/images/edits に mask を付けると 400 を返します(null でも同様)
- レイヤー分解:prompt は省略可、size は段階のみ(デフォルト auto)、入力画像は PNG / JPEG をちょうど 1 枚
- background transparent:透過チャンネル付きの入力画像ちょうど 1 枚、出力は png
現在のキーの GET /v1/models が返す完全な ID を使ってください
画像の内容、構図、スタイル、または編集指示。部分編集では座標、bbox、矢印、参照画像内の塗りつぶし領域を説明できます
制限前後の空白を除いて空にはできません。空の場合は 400「missing prompt」長さ≥ 1 文字
不正な値は生成前に 400 を返して有効な範囲を示し、課金されません
取りうる値2K3K4K
制限略記 2K / 3K / 4K、または 幅x高さ:総ピクセル数 3686400–16777216、アスペクト比 1:16–16:1
その他の値(null を含む)は 400 を返します
制限only a single output is supported (n=1)デフォルト1
url は 24 時間有効な署名付きリンク、b64_json は data[].b64_json を返します。ストリーミングでない組画像では b64_json は使えません(stream: true が必要)
取りうる値urlb64_json
デフォルト"url"
4.5 は jpeg のみ
取りうる値pngjpeg
オブジェクトである必要があります
取りうる値standard
指定すると単一 / 複数画像からの画像生成または編集になります。/v1/images/edits では 1 枚以上が必須です。URL は送信時にダウンロードされず、サイズもチェックされません
制限参照画像(指定すると画像から画像 / 編集):最大 14 枚。Data URL は 1 枚 31457280 バイト以下。URL は送信時にダウンロードされません
seedream-5-0-pro のみ:true で PNG / JPEG の入力画像 1 枚を、ベース画像と最大 16 枚の透過 PNG レイヤーに分解します。このとき prompt は省略可、size は 1K / 1.5K / 2K / auto のみ(デフォルト auto)。1K で約 1.5 分かかるため、クライアントのタイムアウトは 5 分以上に設定してください。詳しくは Seedream · レイヤー分解
制限レイヤー分解には非対応:true を渡すと 400「model seedream-5-0-lite does not support layer_decomposition」指定不可true
本サービスのデフォルトは false(公式のデフォルトは true)。true で透かしを入れる
デフォルトfalse
seedream-5-5 / seedream-5-0-pro のみ:transparent は画像編集専用で、透過チャンネル付きの入力画像がちょうど 1 枚必要です(JPEG / BMP の Data URL は 400)。出力は PNG のため output_format: jpeg は不可。詳しくは Seedream · 透過背景
seedream-5-0-lite / seedream-4-5 のみ:auto で組画像を有効にし、モデルが prompt から枚数を決めます(max_images まで)。失敗した 1 枚は data[].error に入り課金されず、全枚失敗すると 400。ストリーミングでない組画像ではサーバーが最大約 280 秒待つため、stream: true を推奨します。詳しくは Seedream · 組画像
取りうる値autodisabled
デフォルト"disabled"
max_images は 1–15 の整数で、参照画像数 + max_images ≤ 15。multipart では sequential_image_generation_options[max_images] または max_images
組画像の上限枚数。参照画像数 + max_images ≤ 15
範囲1–15
seedream-5-0-lite / seedream-4-5 のみ:true で SSE を返し、1 枚ごとに image_generation.partial_succeeded / image_generation.partial_failed、最後に image_generation.completed と data: [DONE] を送ります。成功した枚数で課金され、ストリーミングのレスポンスには課金額のフィールドが付きません。詳しくは Seedream · ストリーミング
デフォルトfalse
Web 検索は未対応で、渡すと 400
非対応:/v1/images/edits に mask を付けると 400 を返します(null でも同様)
- ストリーミングでない組画像では b64_json は不可(stream=true が必要)
現在のキーの GET /v1/models が返す完全な ID を使ってください
画像の内容、構図、スタイル、または編集指示。部分編集では座標、bbox、矢印、参照画像内の塗りつぶし領域を説明できます
制限前後の空白を除いて空にはできません。空の場合は 400「missing prompt」長さ≥ 1 文字
不正な値は生成前に 400 を返して有効な範囲を示し、課金されません
取りうる値2K4K
制限略記 2K / 4K、または 幅x高さ:総ピクセル数 3686400–16777216、アスペクト比 1:16–16:1
その他の値(null を含む)は 400 を返します
制限only a single output is supported (n=1)デフォルト1
url は 24 時間有効な署名付きリンク、b64_json は data[].b64_json を返します。ストリーミングでない組画像では b64_json は使えません(stream: true が必要)
取りうる値urlb64_json
デフォルト"url"
4.5 は jpeg のみ
取りうる値jpeg
オブジェクトである必要があります
取りうる値standard
指定すると単一 / 複数画像からの画像生成または編集になります。/v1/images/edits では 1 枚以上が必須です。URL は送信時にダウンロードされず、サイズもチェックされません
制限参照画像(指定すると画像から画像 / 編集):最大 14 枚。Data URL は 1 枚 31457280 バイト以下。URL は送信時にダウンロードされません
seedream-5-0-pro のみ:true で PNG / JPEG の入力画像 1 枚を、ベース画像と最大 16 枚の透過 PNG レイヤーに分解します。このとき prompt は省略可、size は 1K / 1.5K / 2K / auto のみ(デフォルト auto)。1K で約 1.5 分かかるため、クライアントのタイムアウトは 5 分以上に設定してください。詳しくは Seedream · レイヤー分解
制限レイヤー分解には非対応:true を渡すと 400「model seedream-4-5 does not support layer_decomposition」指定不可true
本サービスのデフォルトは false(公式のデフォルトは true)。true で透かしを入れる
デフォルトfalse
seedream-5-5 / seedream-5-0-pro のみ:transparent は画像編集専用で、透過チャンネル付きの入力画像がちょうど 1 枚必要です(JPEG / BMP の Data URL は 400)。出力は PNG のため output_format: jpeg は不可。詳しくは Seedream · 透過背景
seedream-5-0-lite / seedream-4-5 のみ:auto で組画像を有効にし、モデルが prompt から枚数を決めます(max_images まで)。失敗した 1 枚は data[].error に入り課金されず、全枚失敗すると 400。ストリーミングでない組画像ではサーバーが最大約 280 秒待つため、stream: true を推奨します。詳しくは Seedream · 組画像
取りうる値autodisabled
デフォルト"disabled"
max_images は 1–15 の整数で、参照画像数 + max_images ≤ 15。multipart では sequential_image_generation_options[max_images] または max_images
組画像の上限枚数。参照画像数 + max_images ≤ 15
範囲1–15
seedream-5-0-lite / seedream-4-5 のみ:true で SSE を返し、1 枚ごとに image_generation.partial_succeeded / image_generation.partial_failed、最後に image_generation.completed と data: [DONE] を送ります。成功した枚数で課金され、ストリーミングのレスポンスには課金額のフィールドが付きません。詳しくは Seedream · ストリーミング
デフォルトfalse
Web 検索は未対応で、渡すと 400
非対応:/v1/images/edits に mask を付けると 400 を返します(null でも同様)
- ストリーミングでない組画像では b64_json は不可(stream=true が必要)
レスポンス
200同期で成功
202Prefer: respond-async 指定時
レスポンスヘッダー
このリクエストの課金額の人民元額(X-HopBase-Cost-USD と同じ課金額)で、小数点以下最大 6 桁(例: 0.0816)。課金が発生したときだけ返します。ストリーミング(SSE)では返しません。画像生成が約 40 秒を超えるとレスポンスヘッダーは先に送信済みのため、レスポンスボディの usage.cost を参照してください
このリクエストで残高から実際に差し引かれた米ドル額。利用履歴の該当レコードと同じ金額で、小数点以下最大 8 桁(例: 0.012)。X-HopBase-Cost と一緒にのみ返します
X-HopBase-Cost の通貨。常に CNY
Unix 秒
画像 1 枚につき 1 項目
GPT Image / Gemini:Base64 の画像データ。デコード後は output_format に従って保存します。Gemini は JPEG の場合があるため mime_type を確認してください。Seedream も response_format: b64_json のときこのフィールドを返します
Seedream:24 時間有効な署名付き直リンク。期限切れ後は再生成するしかありません
Seedream 組画像:この 1 枚の生成に失敗(多くはコンテンツ審査)、課金なし
エラーコード
失敗の理由
Seedream:実際の出力 WIDTHxHEIGHT
Seedream レイヤー分解:ベース画像はリクエストの output_format、レイヤーは常に png
Seedream レイヤー分解:ベース画像が 0、レイヤーは 1 から始まり昇順に重なる
Seedream レイヤー分解(レイヤーのみ):ベース画像上のレイヤーの位置
[left, top, right, bottom]、ベース画像のピクセル座標
同じ枠の正規化座標、0–999
Seedream レイヤー分解(レイヤーのみ):レイヤー名
Seedream レイヤー分解(レイヤーのみ):レイヤーの内容の説明
画像の MIME
モデルが書き換えたプロンプト(一部のモデル)
返される場合あり
入力トークン
出力トークン
合計
Grok Imagine:xAI 公式の計量値。単位は 1e-10 米ドルで公式価格による換算値であり、課金額ではありません。残高から実際に差し引かれた米ドル額は cost_usd、cost は同じ課金の人民元額です
ゲートウェイが付加:このリクエストの課金額の人民元額(cost_usd と同じ課金額)。レスポンスヘッダー X-HopBase-Cost と同じ。ストリーミングでは返しません
ゲートウェイが付加:残高から実際に差し引かれた米ドル額。レスポンスヘッダー X-HopBase-Cost-USD および利用履歴と同じ。ストリーミングでは返しません
ゲートウェイが付加:cost の通貨。常に CNY
エラー
missing_api_key / invalid_api_key / api_key_expired)insufficient_quota)model_not_found)、またはパスがそのグループに属さない(route_not_found)request_too_large)user_concurrency_limit / apikey_concurrency_limit)。Retry-After 付き