curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.5-flare",
    "prompt": "雨の窓辺にある居心地のよい読書スペース、暖かなランプの光",
    "size": "1:1",
    "resolution": "1k",
    "quality": "medium",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KXXXXXXXXXXXXXXX"
    }
  ]
}

{
  "error": {
    "code": 400,
    "message": "リクエストパラメータが無効です",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "認証に失敗しました。API キーを確認してください。",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "アカウント残高が不足しています",
    "type": "payment_required"
  }
}

GPT-Image-2.5

GPT-Image-2.5 画像生成

gpt-image-2.5-flare と gpt-image-2.5-sunburst を提供
非同期処理で task_id を返し、後から結果を取得
テキスト画像生成と最大 16 枚の参照画像を使った編集に対応
透過 PNG マスクを使った局所的な再描画に対応
15 種類のアスペクト比、任意のピクセル寸法、1K / 2K / 4K に対応
low / medium / high / xhigh / max の品質設定

POST

images

generations

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.5-flare",
    "prompt": "雨の窓辺にある居心地のよい読書スペース、暖かなランプの光",
    "size": "1:1",
    "resolution": "1k",
    "quality": "medium",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KXXXXXXXXXXXXXXX"
    }
  ]
}

{
  "error": {
    "code": 400,
    "message": "リクエストパラメータが無効です",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "認証に失敗しました。API キーを確認してください。",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "アカウント残高が不足しています",
    "type": "payment_required"
  }
}

モデルの選び方： gpt-image-2.5-flare は高速で、日常的な高品質画像、バッチ生成、試作に適しています。gpt-image-2.5-sunburst は編集精度を重視し、完成品レベルの商品画像、広告クリエイティブ、細かな複数回編集に適しています。料金は両モデルで同じです。

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.5-flare",
    "prompt": "雨の窓辺にある居心地のよい読書スペース、暖かなランプの光",
    "size": "1:1",
    "resolution": "1k",
    "quality": "medium",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KXXXXXXXXXXXXXXX"
    }
  ]
}

{
  "error": {
    "code": 400,
    "message": "リクエストパラメータが無効です",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "認証に失敗しました。API キーを確認してください。",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "アカウント残高が不足しています",
    "type": "payment_required"
  }
}

認証

string

必須

すべてのエンドポイントで Bearer Token 認証が必要です。API キーページでキーを取得してください。

Authorization: Bearer YOUR_API_KEY

モデルの選択

モデル	特長	推奨用途
`gpt-image-2.5-flare`	高速な標準モデル	SNS、商品画像、ビジュアル検索、試作、バッチ生成
`gpt-image-2.5-sunburst`	編集精度を優先	完成品の商品画像、広告、複数回の精密編集

同じパラメータでは両モデルのトークン消費量と料金は同一です。gpt-image-2 と比べて xhigh と max が追加され、medium と high の出力トークンは旧世代の同名レベルのおよそ 4 分の 1 です。

リクエストパラメータ

string

必須

gpt-image-2.5-flare または gpt-image-2.5-sunburst。

string

必須

生成または編集する画像の説明。被写体、場面、構図、スタイル、照明、維持または変更する要素を具体的に記述してください。

string

デフォルト:"auto"

出力のアスペクト比または正確なピクセル寸法。

auto：プロンプトまたは参照画像から自動選択
比率：1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、21:9、9:21、3:1、1:3
正確な寸法（例：1600x1200）

画像編集では size を省略すると、入力画像の比率と resolution から出力寸法が計算されます。

string

デフォルト:"1k"

解像度：1k、2k、4k。size が正確なピクセル寸法の場合は無視されます。

string

デフォルト:"auto"

画質：low、medium、high、xhigh、max、auto。

xhigh と max は GPT-Image-2.5 専用です。gpt-image-2 に指定すると HTTP 400 になり、自動的な品質低下は行われません。

integer

デフォルト:"1"

生成枚数。1～4 の数値を指定します。

string

デフォルト:"png"

出力形式：png、jpeg、webp。

integer

0～100 の圧縮率。jpeg と webp のみ有効です。

string

背景：transparent、opaque、auto。

transparent は png または webp と組み合わせてください。JPEG はアルファチャンネルに対応しません。

string

デフォルト:"low"

コンテンツ審査レベル：auto または low。省略時は APIMart が low を明示的に送信し、指定された auto はそのまま使用されます。

string[]

画像生成・編集用の参照画像 URL。最大 16 枚で、指定すると編集モードになります。公開アクセス可能な HTTP(S) URL のみ利用できます。ローカル画像は POST /v1/uploads/images でアップロードし、返された url を使用してください。

string

局所的な再描画に使用するマスク画像です。image_urls も指定した場合にのみ有効です。gpt-image-2.5-flare と gpt-image-2.5-sunburst の両方で利用できます。次のいずれかを単一の文字列で指定します。

サーバーから直接ダウンロードできる HTTP(S) 画像 URL
data:image/png;base64,... 形式の PNG Data URL

マスクの要件：

Alpha 透過チャンネルを持つ PNG を使用し、入力元画像にも PNG を推奨
ピクセル寸法は image_urls[0] と完全に一致させる。出力 size ではなく、最初の入力元画像に合わせる
完全に透明なピクセル（alpha=0）が編集対象で、それ以外の領域は保持に使用される
1 回のリクエストにつきマスクは 1 枚。複数の参照画像がある場合も、最初の入力画像にのみ適用される
一般のファイルサイズガイドは 50 MB 未満、mask パラメータ仕様は 4 MB 未満と記載されている。検証前は厳しい方の 4 MB に合わせる

Alpha チャンネルのない通常の白黒画像は、そのままマスクとして使用できません。APIMart は Alpha チャンネルを自動追加せず、現時点ではマスクと元画像の寸法一致も事前検証しないため、どちらも呼び出し側で保証してください。

HTTP(S) URL は Cookie や追加の認証ヘッダーなしでアクセスできる必要があります。署名付き URL はキュー待ちと実行が終わるまで有効にしてください。既定のダウンロード上限は 20 MB、タイムアウトは 60 秒ですが、デプロイ設定で上書きされる場合があります。マスクは編集を誘導するものであり、マスク境界外のピクセルが完全に変化しないことは保証されません。

サイズ制約

幅と高さはいずれも 16 の倍数
一辺は 3840 ピクセル以下
長辺と短辺の比率は 3:1 以下
総ピクセル数は 655,360～8,294,400

2560×1440 を超える解像度は実験的で、一般的な解像度より安定性が低い場合があります。

比率と解像度の対応

`size`	`1k`	`2k`	`4k`
`1:1`	1024×1024	2048×2048	2880×2880
`3:2`	1536×1024	2048×1360	3520×2336
`2:3`	1024×1536	1360×2048	2336×3520
`4:3`	1024×768	2048×1536	3312×2480
`3:4`	768×1024	1536×2048	2480×3312
`5:4`	1280×1024	2560×2048	3216×2576
`4:5`	1024×1280	2048×2560	2576×3216
`16:9`	1536×864	2048×1152	3840×2160
`9:16`	864×1536	1152×2048	2160×3840
`2:1`	2048×1024	2688×1344	3840×1920
`1:2`	1024×2048	1344×2688	1920×3840
`21:9`	2016×864	2688×1152	3840×1648
`9:21`	864×2016	1152×2688	1648×3840
`3:1`	1536×512	3072×1024	3840×1280
`1:3`	512×1536	1024×3072	1280×3840

サイズ制約を満たす任意の正確な寸法も指定できます。

編集例

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "商品とパッケージの文字を維持し、背景を柔らかなオフホワイトのスタジオに変更して自然な影を追加する",
  "image_urls": ["https://example.com/product.png"],
  "resolution": "2k",
  "quality": "xhigh"
}

マスクを使った局所的な再描画

次の例では、マスク内の完全に透明な領域だけを編集します。マスク寸法は product.png と一致させてください。

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "透明マスクで覆われた領域だけを金色のリボンに変更し、商品とその他の背景を保持する",
  "image_urls": [
    "https://example.com/product.png"
  ],
  "mask_url": "https://example.com/product-mask.png",
  "quality": "xhigh"
}

送信とタスク照会

送信成功時のタスク ID は data[0].task_id にあります。タスク状態 API を 2～5 秒ごとに呼び出し、completed または failed になるまで確認してください。複数タスクには POST /v1/tasks/batch を利用できます。

{
  "code": 200,
  "data": {
    "id": "task_01KXXXXXXXXXXXXXXX",
    "status": "completed",
    "progress": 100,
    "cost": 0.01325,
    "result": {
      "images": [{
        "url": ["https://upload.apimart.ai/f/image/example.png"],
        "expires_at": 1789000000
      }]
    },
    "usage": {
      "input_tokens": 16,
      "output_tokens": 439,
      "total_tokens": 455
    }
  }
}

画像 URL は data.result.images[].url[] にあります。早めにダウンロードして保存してください。

状態	意味
`submitted`	送信済み
`processing`	生成中
`completed`	成功。`result.images` を取得可能
`failed`	失敗。`error.message` を確認し、予約額は返金

料金

GPT-Image-2.5 は実際のトークン使用量で課金されます。料金ページまたは /api/pricing で現在の料金を確認してください。

項目	100 万トークンあたり
画像出力	$30.00
画像入力	$8.00
キャッシュ済み画像入力	$2.00
テキスト入力	$5.00
キャッシュ済みテキスト入力	$1.25

1024×1024 の `quality`	出力トークン	公式出力コスト
`low`	196	$0.00588
`medium`	439	$0.01317
`high`	1756	$0.05268
`xhigh`	3122	$0.09366
`max`	7024	$0.21072

quality: "auto" では、選択サイズの max 相当額を先に予約し、完了後に実使用量で精算して差額を解放します。

n > 1 の予約額は枚数に比例します。失敗したタスクは自動返金されます。

制限とよくあるエラー

項目	制限または対処
1 リクエストの枚数	1～4
参照画像	最大 16 枚
出力形式	PNG / JPEG / WebP
透明背景	PNG / WebP のみ
部分画像ストリーミング	非対応
無効な品質	`xhigh` / `max` には GPT-Image-2.5 が必要
無効な寸法	ピクセル数と比率の範囲内で 16 の倍数を使用

Response

integer

レスポンスコード。送信成功時は 200。

array

送信レスポンスのデータ。

表示配列要素

string

初期状態は submitted。

string

状態と結果の取得に使う一意のタスク ID。

概要

モデル

テキストシリーズ

画像シリーズ

動画シリーズ

オーディオシリーズ

モデレーションシリーズ

アップロード管理

タスク管理

アカウント管理

GPT-Image-2.5 画像生成

認証

モデルの選択

リクエストパラメータ

サイズ制約

比率と解像度の対応

編集例

マスクを使った局所的な再描画

送信とタスク照会

料金

制限とよくあるエラー

Response

​認証

​モデルの選択

​リクエストパラメータ

​サイズ制約

​比率と解像度の対応

​編集例

​マスクを使った局所的な再描画

​送信とタスク照会

​料金

​制限とよくあるエラー

​Response

認証

モデルの選択

リクエストパラメータ

サイズ制約

比率と解像度の対応

編集例

マスクを使った局所的な再描画

送信とタスク照会

料金

制限とよくあるエラー

Response