Skip to main content
POST

Authorizations

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

Body

string
デフォルト:"gpt_image_2_official"
必須
画像生成モデル名固定で gpt_image_2_official を入力してください(OpenAI公式のgpt-image-2モデル)
object
必須
モデルパラメータオブジェクト
string
必須
発信者タスクIDユーザーが定義するタスク識別子、必須

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

aspect_ratio × resolution → OpenAI 実際ピクセル(13 比率 × 3 レベル):
3:2 / 2:3 @ 2K は実際には 2048×1360(概算比率、誤差 < 0.5%);4K は6つの比率のみサポート(総ピクセルがOpenAI上限超過の組み合わせは使用不可)。

Response

integer
レスポンスステータスコード
array
返却データの配列

タスク結果の問い合わせ

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

ポーリングの推奨

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