curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2",
    "params": {
      "prompt": "窓辺に座って夕日を見ている茶トラ猫、水彩画風",
      "aspect_ratio": "16:9"
    },
    "out_task_id": "my_task_123456"
  }'

{
    "statusCode": 200,
    "message": "",
    "data": {
        "out_task_id": "my_task_123456",
        "status": "pending",
        "estimated_credits": 100,
        "created_at": "2025-12-22T06:03:28.242Z"
    }
}

GPT-Image-2

GPT-Image-2 画像生成

非同期処理モードで、後続クエリ用にタスクIDを返します
OpenAI Images互換プロトコルに基づき、テキストから画像生成および画像から画像生成をサポート
13種類の画像比率を aspect_ratio フィールドで指定可能
resolution フィールドを追加し、1K / 2K / 4K 解像度選択（4Kは全比率対応）をサポート
size フィールドを追加し、ピクセルサイズのカスタマイズをサポート（aspect_ratio / resolution と排他、合計ピクセル数が2,088,960以上で正確な出力可能)
参照画像は最大10枚まで、URLとbase64混在可能
提出されたプロンプトはプラットフォームの禁止語句および安全審査を通過し、違反内容は即時拒否されます

POST

api

openapi

submit

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2",
    "params": {
      "prompt": "窓辺に座って夕日を見ている茶トラ猫、水彩画風",
      "aspect_ratio": "16:9"
    },
    "out_task_id": "my_task_123456"
  }'

{
    "statusCode": 200,
    "message": "",
    "data": {
        "out_task_id": "my_task_123456",
        "status": "pending",
        "estimated_credits": 100,
        "created_at": "2025-12-22T06:03:28.242Z"
    }
}

Authorizations

Authorization

string

必須

すべてのエンドポイントはBearer Tokenで認証が必要ですAPIキーの取得方法：API Key 管理ページにアクセスしてAPIキーを取得してください使用時はリクエストヘッダーに以下を追加します：

Authorization: Bearer YOUR_API_KEY

Body

model

string

必須

モデル名固定値："gpt_image_2"

params

object

必須

モデルのパラメーターオブジェクト

表示 params オブジェクトのプロパティ

prompt

string

必須

画像生成のテキスト説明

日本語と英語をサポートし、詳細な説明を推奨します
提出前にプラットフォームの敏感語 / セキュリティ審査を経て、違反内容が検出された場合はエラーを直接返します

image_url

string[]

参考画像の配列。渡すと画像生成モードになります

最大 10 枚の参考画像まで
以下の2つの形式がサポートされています：
1. 公開アクセス可能な URL
2. Base64エンコード形式
  - 完全な Data URI 形式を使用する必要があります：data:image/{形式};base64,{base64データ}
  - 対応画像形式：jpeg、png、webp
  - 例：data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  - ⚠️ 注意：data:image/jpeg;base64, のプレフィックス部分が必須です

aspect_ratio

string

デフォルト:"auto"

画像生成のアスペクト比デフォルト値は resolution によって変わります：

resolution が 1K / 2K の場合、未指定は auto
resolution が 4K の場合、未指定は 16:9

以下の値をサポートします：

auto - 自動的に最適な比率を選択
1:1 - 正方形
16:9 / 9:16 - ワイドスクリーン横 / 縦
4:3 / 3:4 - 標準横 / 縦
3:2 / 2:3 - クラシック横 / 縦
5:4 / 4:5 - ほぼ正方形横 / 縦
2:1 / 1:2 - ワイド横 / 縦長
21:9 / 9:21 - 超ワイド横 / 超縦長

比率は文字列または auto のみサポートしており、ピクセルサイズ（例：1024x1024）を渡すとエラーになります

resolution

string

デフォルト:"1K"

解像度のレベル実際の生成画像の鮮明さを制御します：

1K - 1024基準、コスト削減の日常利用に十分（デフォルト）
2K - 2048基準、ポスターや高精細のニーズに適合
4K - 3840基準、13 全ての比率をサポート

size を渡す場合、resolution と aspect_ratio は同時に渡せません。両方渡すと400エラーを返します。

size

string

カスタムのピクセルサイズ（aspect_ratio / resolution と排他）形式は 幅x高さ で、例：2048x1536、3840x2160。使用制限：

形式は ^\d+x\d+$ のみで、例：2048x1536。他の形式はサポートしません
aspect_ratio、resolution と排他で、3つのうち1つのみ選択可能。同時に渡すと400エラー
総ピクセル数（幅×高さ）は 655,360 ～ 8,294,400 の範囲内である必要があります

実測のピクセル下限：

総ピクセル範囲	上流の動作
≥ 2,088,960（約2.0M）	渡した `size` で正確に生成 ✅
< 2,088,960	約1.57Mの近い比率に静かに置き換え（`size`未指定と同等）⚠️

総ピクセル数が約2,088,960未満の場合、上流からはエラーが出ませんが静かにサイズを置き換えて出力します。正確に制御したい場合は、総ピクセル数を2,088,960以上にすることを推奨します。小サイズのニーズがある場合は aspect_ratio と resolution=1K の組み合わせを使用してください。

推奨利用パターン：

ニーズ	推奨方法
ピクセルサイズを正確に制御	`size` かつ総ピクセル数 ≥ 2,088,960
小サイズ（2Mピクセル未満）	`aspect_ratio` + `resolution=1K`
中・大サイズの任意比率	`size`、2K / 4K 範囲内で任意の比率で正確に生成可能

out_task_id

string

必須

発注者のタスクIDユーザーがカスタムで定義するタスク識別子、必須

サイズ × 解像度対応表

aspect_ratio × resolution → 実際のピクセル（13の比率 × 3つのレンジ）：

aspect_ratio	`1K`	`2K`	`4K`
`1:1`	1024×1024 / 1254×1254	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 / 1448×1086	2560×2048	3216×2576
`4:5`	1024×1280 / 1122×1402	2048×2560	2576×3216
`16:9`	1536×864 / 1672×941	2048×1152	3840×2160
`9:16`	864×1536 / 941×1672	1152×2048	2160×3840
`2:1`	2048×1024 / 1774×887	2688×1344	3840×1920
`1:2`	1024×2048 / 887×1774	1344×2688	1920×3840
`21:9`	2016×864 / 1915×821	2688×1152	3840×1648
`9:21`	864×2016 / 821×1915	1152×2688	1648×3840

3:2 / 2:3 @ 2K は実際には2048×1360（近似比率、誤差 < 0.5%）です；4Kは現在13種の比率すべてに対応しています。

カスタムサイズ（size パラメータ）

ピクセルサイズを正確に制御する場合、aspect_ratio + resolution の組み合わせの代わりに size パラメータを使用できます。 有効範囲： 合計ピクセル数 655,360 ～ 8,294,400（上流公式制限） 実測有効下限： 合計ピクセル数 ≥ 2,088,960（約 1440×1452 または 2048×1020 の同等面積）下限より少ない場合、上流ではエラーが発生しませんが、約1.57Mピクセルの近い比率サイズに静かに置き換えられます。

よく使う size の例

size 値	合計ピクセル数	推奨用途
`2048x2048`	4,194,304	正方形の高解像度
`2048x1536`	3,145,728	4:3 横向き
`1536x2048`	3,145,728	3:4 縦向き
`2048x1152`	2,359,296	16:9 横向き
`1152x2048`	2,359,296	9:16 縦向き
`3840x2160`	8,294,400	4K 16:9（最高品質）
`2688x1344`	3,612,672	2:1 幅広横向き

aspect_ratio または resolution と同時に渡さないでください。そうしないと 400 が返されます。

Response

out_task_id

string

発注者のタスクID。結果の照会に使用可能

status

string

初期ステータス。固定で "pending"

estimated_credits

number

推定消費クレジット

created_at

string

作成日時（ISO形式）

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2",
    "params": {
      "prompt": "窓辺に座って夕日を見ている茶トラ猫、水彩画風",
      "aspect_ratio": "16:9"
    },
    "out_task_id": "my_task_123456"
  }'

{
    "statusCode": 200,
    "message": "",
    "data": {
        "out_task_id": "my_task_123456",
        "status": "pending",
        "estimated_credits": 100,
        "created_at": "2025-12-22T06:03:28.242Z"
    }
}

GPT-4o 画像生成 GPT-Image-2 公式チャネル画像生成

Documentation Index

​Authorizations

​Body

​サイズ × 解像度対応表

​カスタムサイズ（size パラメータ）

​よく使う size の例

​Response

Authorizations

Body

サイズ × 解像度対応表

カスタムサイズ（size パラメータ）

よく使う size の例

Response