メインコンテンツへスキップ
POST
モデルは gpt-image-2.6-ext、version は flare / sunburst。画像単位で課金します。resolution は 1k / 2k / 4k に対応し、現在は n: 1 を使用します。すべての品質レベルと PNG / JPEG / WebP / SVG / GIF に対応しています。
本ページは Ext API です。トークン課金版 GPT-Image-2.6とはモデル名とパラメータ規則が異なります。

認証

string
必須
プラットフォームの API キーで Bearer Token 認証を行います。API キー管理で取得してください。送信には Content-Type: application/json を使用します。

バージョン選択

リクエストパラメータ

列挙値は大文字・小文字を区別せず、前後の空白は除去されます。例では小文字を使用します。
string
必須
固定値 gpt-image-2.6-ext。
string
必須
生成・編集の指示。必須で空文字は不可。複数画像では「1 枚目」「2 枚目」と指定し、変更・維持する内容を記述します。
string
デフォルト:"flare"
flare / sunburst。省略時は flare。その他は HTTP 400。バージョン間で価格が異なる場合があります。
string
デフォルト:"1k"
1k / 2k / 4k(大文字 1K / 2K / 4K も可)。size の比率と組み合わせて出力ピクセルが決まります(下の「比率と寸法」表を参照)。1 枚あたりの価格は解像度ごとに異なります。hd / 8k などは HTTP 400。
string
デフォルト:"auto"
auto または下表の 10 比率のみ。1024x1024 などのピクセル指定は不可。auto のテキスト生成は 1:1、編集は寸法を読み取れる最初の参照画像に最も近い対応比率を選びます。GIF では省略または auto を使用します。
string
size の別名。どちらか一方を使用します。両方指定する場合は一致が必要で、不一致は HTTP 400。GIF では省略または auto のみ。
integer
デフォルト:"1"
現在は整数 1 を使用してください。
string
auto / low / medium / high / xhigh / max。省略時は上流に転送せず自動選択に任せます。auto は low 固定ではありません。画像単価は変わりませんが、高品質ほど通常時間がかかります。その他は HTTP 400。
string
デフォルト:"png"
png / jpeg / webp / svg / gif。jpg は jpeg の別名。SVG・GIF はテキスト生成のみ。その他は HTTP 400。
SVG 出力は現在未対応です。
string
low / medium / high。省略時は上流が決定します。画面の複雑さを制御し、low は簡潔なアイコンやフラットイラスト、high は豊かな細部向け。単価は変わりません。
string[]
最大 16 枚、各 20 MB 以下。PNG / JPEG / WebP / GIF / BMP。公開 HTTP(S) URL または data:image/png;base64,... などの画像 Data URL に対応。指定すると編集モード。SVG・GIF では参照画像不可。
resolution が 2k / 4k の場合、参照画像に GIF / BMP は使用できません。
別名 image_url、image、images、input_image、input_images にも対応しますが、image_urls を推奨します。URL はログイン不要で公開アクセスできる必要があります。

比率と寸法

auto のテキスト生成は 1:1(1k 1024×1024、2k 2048×2048、4k 2880×2880)。編集では上表の最も近い比率を選ぶため、元画像と同じピクセル寸法は保証されません。

参照画像の編集例

編集も POST /v1/images/generations を使用します。例の URL は実際にアクセス可能な画像に置き換えてください。

SVG 出力

output_format: "svg" を指定。テキスト生成のみ、n=1 が必須です。size は比率指定に対応し、complexity: "low" は簡潔なベクター画像に適しています。
object
任意の SVG 作成モデル設定。SVG 出力専用で、オブジェクト全体を省略可能です。SVG を作成するテキストモデルに追加料金はかかりません。

GIF アニメーション

output_format: "gif" を指定。テキスト生成のみ。size / aspect_ratio は省略または auto。比率名やピクセル値は HTTP 400。動きとループを指示してください。

非対応・無効なパラメータ

送信とタスク結果

送信成功は HTTP 200。data[0].task_id を取得し、タスク照会 APIを 3–5 秒間隔で completed / failed まで呼び出します。クライアントがタイムアウトしても生成を再送せず、既存タスクを照会してください。
以下はタスクオブジェクトです。レスポンスが {code, data} 形式なら先に data を取得します。Python / JavaScript 例は両形式を処理します。
result.images[0].url は配列で、最初のリンクは result.images[0].url[0]。expires_at より前に保存してください。推奨有効期間は完了後 24 時間です。cost / credits_cost は最終料金です。 一括照会は POST /v1/tasks/batch、本文は {"task_ids":["task_xxx","task_yyy"]}。

課金

単価は version × resolution のみで決定します。品質、形式(SVG / GIF を含む)、複雑さ、比率、参照数、svg.model は価格に影響しません。現在は n=1 を使用し、失敗は全額返金されます。最新料金は APIMart 料金ページまたは /api/pricing を参照してください。

エラー処理