Skip to main content
POST

サポートモデル

Authorizations

string
必須
すべてのAPIリクエストにはBearer Token認証が必要ですAPIキーの取得:APIキー管理ページにアクセスしてAPIキーを取得してくださいリクエストヘッダーに以下を追加:

Body

string
必須
モデル名
  • gpt-image-1-official - 安定性重視、汎用画像生成に最適
  • gpt-image-1.5-official - 新バージョン、高品質・複雑な編集に最適
string
必須
画像生成のテキスト説明、中国語と英語に対応
string
デフォルト:"1:1"
アスペクト比対応する比率:
  • 1:1 - 正方形(デフォルト)
  • 3:2 - 横長
  • 2:3 - 縦長
integer
デフォルト:"1"
生成枚数範囲:1-4
  • 0以下の値は 1 として処理されます
  • 4を超える値は 4 として処理されます
⚠️ 注意: 純粋な数値(例:1)を入力してください。引用符を付けるとエラーになります
string
デフォルト:"auto"
画像品質
  • auto - 自動品質選択(デフォルト)
  • low - より高速、より経済的
  • medium - 品質とコストのバランス
  • high - より高品質、コスト増
string
デフォルト:"auto"
背景モード
  • auto - 自動背景(デフォルト)
  • opaque - 不透明背景
  • transparent - 透明背景、png 出力形式との併用推奨
background: transparentoutput_format: jpeg は同時に使用できません
string
デフォルト:"auto"
モデレーションレベル
  • auto - デフォルトのモデレーションレベル
  • low - より緩やかなモデレーション
string
デフォルト:"png"
出力形式
  • png - デフォルト形式、透明背景に最適
  • jpeg - ファイルサイズが小さい、一般的な画像出力に最適
background: transparentoutput_format: jpeg は同時に使用できません
integer
出力圧縮レベル、範囲 0-100
  • jpeg でのみ使用推奨
  • png では設定不要
array
参照画像のURL配列、指定すると画像から画像モードが有効になります制限: 最大15枚の参照画像
string
マスク画像URL、インペインティング用
  • image_urls と併用する必要があります
  • 公式編集APIで一緒に送信されます
1、マスク画像をアップロードする前に、画像のAlphaチャンネルが「はい」であることを確認してください。2、マスク画像のサイズは最初の参考画像と一致する必要があります。

サイズ対照表

アスペクト比を外部で使用し、システム内部で公式の実際のサイズに自動マッピングします。

使用例

テキストから画像(最小リクエスト)
テキストから画像(全パラメータ)
画像から画像(単一参照画像)
画像から画像(複数参照画像の融合)
複数枚生成(n > 1)

Response

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

注意事項

  1. 非同期処理:送信後に task_id が返されます。/v1/tasks/{task_id} をポーリングして結果を取得してください
  2. モデル選択:汎用画像生成には gpt-image-1-official を優先使用。高品質編集や複雑な画像から画像には gpt-image-1.5-official を推奨
  3. 画像URL要件:画像から画像には、公開アクセス可能な安定した画像URLを使用してください
  4. 課金ルール:正常に生成された画像枚数で課金、失敗時は課金なし