curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2_official",
    "params": {
      "prompt": "星空の下の古い城",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "quality": "high"
    },
    "out_task_id": "my_task_123456"
  }'

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

GPT-Image-2

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

OpenAI公式のgpt-image-2モデル、/v1/images/generations互換プロトコルに基づく
非同期処理モード、後続のクエリ用にtask_idを返す
テキスト画像生成 / 画像変換三合一
新たにresolutionフィールドを追加、1K / 2K / 4K解像度をサポート
13種類のアスペクト比をサポート（4Kはそのうち6つを対応：16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21）
参照画像は最大9枚まで、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_official",
    "params": {
      "prompt": "星空の下の古い城",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "quality": "high"
    },
    "out_task_id": "my_task_123456"
  }'

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

Authorizations

Authorization

string

必須

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

Authorization: Bearer YOUR_API_KEY

Body

model

string

デフォルト:"gpt_image_2_official"

必須

画像生成モデル名固定で gpt_image_2_official を入力してください（OpenAI公式のgpt-image-2モデル）

params

object

必須

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

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

prompt

string

必須

画像生成のテキスト説明

日本語・英語対応、詳細に説明することを推奨
提出前にプラットフォームの検閲・安全審査を通過し、不適切な内容があればエラーを返します

aspect_ratio

string

デフォルト:"1:1"

画面比率外部には比率値を使用し、システム内部で resolution により具体的なピクセルに自動マッピングされます。13種類の比率に対応：

1:1 - 正方形構図（デフォルト、SNSのプロフィール画像／ロゴ）
3:2 - 横長構図（一眼レフカメラで一般的な比率）
2:3 - 縦長構図（ポスター縦版）
4:3 - 横長構図（クラシックディスプレイ／PPT）
3:4 - 縦長構図
5:4 - 横長構図
4:5 - 縦長構図（Instagram縦型投稿）
16:9 - 横長構図（ワイドスクリーンの動画カバー）
9:16 - 縦長構図（スマホ全画面／ショート動画のカバー）
2:1 - 横長構図（ウェブのバナー）
1:2 - 縦長構図
21:9 - 横長構図（映画の超ワイドスクリーン）
9:21 - 縦長構図

比率形式のみ対応、ピクセルサイズ（例：1024x1024）を使うとエラーになります

resolution

string

デフォルト:"1K"

解像度設定実際の画像の鮮明さを制御：

1K - 1024基準、コスト節約で日常的に十分（デフォルト）
2K - 2048基準、ポスターや高解像度が必要な場合
4K - 3840基準、6つの比率のみ対応（16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21）

非対応の4K組み合わせは400エラーを返します：

1:1 × 4K ❌（ピクセル数上限超過）
3:2 / 2:3 × 4K ❌（ピクセル数上限超過）
4:3 / 3:4 × 4K ❌（ピクセル数上限超過）
5:4 / 4:5 × 4K ❌（ピクセル数上限超過）

これらの比率で高解像度が必要な場合は resolution=2K を使用してください。

quality

string

デフォルト:"low"

画像品質

low - 速くてコスト低め、輪郭十分（デフォルト）
medium - バランス良し
high - 最高精度（4K + high は処理時間 >120秒）

image_url

array

参考画像の配列。渡すと画像生成モードで動作します

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

out_task_id

string

必須

発信者タスクIDユーザーが定義するタスク識別子、必須

サイズ × 解像度マッピング表

aspect_ratio × resolution → OpenAI 実際ピクセル（13 比率 × 3 レベル）：

aspect_ratio	`1K`	`2K`	`4K`
`1:1`	1024×1024	2048×2048	❌ ピクセル上限超過
`3:2`	1536×1024	2048×1360	❌ ピクセル上限超過
`2:3`	1024×1536	1360×2048	❌ ピクセル上限超過
`4:3`	1024×768	2048×1536	❌ ピクセル上限超過
`3:4`	768×1024	1536×2048	❌ ピクセル上限超過
`5:4`	1280×1024	2560×2048	❌ ピクセル上限超過
`4:5`	1024×1280	2048×2560	❌ ピクセル上限超過
`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:2 / 2:3 @ 2K は実際には 2048×1360（概算比率、誤差 < 0.5%）；4K は6つの比率のみサポート（総ピクセルがOpenAI上限超過の組み合わせは使用不可）。

Response

code

integer

レスポンスステータスコード

data

array

返却データの配列

表示プロパティ

status

string

タスクステータス

submitted - 送信済み

task_id

string

タスクの一意識別子。後続のタスク結果のクエリに使用されます

タスク結果の問い合わせ

送信成功後に task_id が返され、GET /v1/tasks/{task_id} でタスクの状態をポーリングします。詳細はタスク問い合わせAPI をご参照ください。

ポーリングの推奨

初回問い合わせ遅延：送信後10〜20秒待ってから問い合わせを開始してください
問い合わせ間隔：3〜5秒に1回が推奨されます
タイムアウト目安：high + 2K/4K の組み合わせで最大130秒かかることがあり、クライアントのタイムアウトは180秒以上を推奨します

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2_official",
    "params": {
      "prompt": "星空の下の古い城",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "quality": "high"
    },
    "out_task_id": "my_task_123456"
  }'

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

GPT-Image-2 画像生成 Seedream V4 画像生成

Documentation Index

​Authorizations

​Body

​サイズ × 解像度マッピング表

​Response

​タスク結果の問い合わせ

​ポーリングの推奨

Authorizations

Body

サイズ × 解像度マッピング表

Response

タスク結果の問い合わせ

ポーリングの推奨