メインコンテンツへスキップ
POST
GPT-Image-2.6 画像生成
標準ティアは POST /v1/images/generations で画像タスクを作成し, タスク ID を返します. タスク完了後, ステータスエンドポイントで画像 URL を取得します. 両モデルとも同じリクエスト形式です: gpt-image-2.6 はシリーズ名です. 必ず表の完全なモデル名を指定してください.
中国本土のユーザーへ: API エンドポイント (Base URL) には https://api.toapis.cn をご利用ください. 本ドキュメントの例に含まれる https://api.toapis.com を https://api.toapis.cn に置き換えてください.
API Key は コンソール で作成します.

クイックスタート

ToAPIs API Key を環境変数 TOAPIS_API_KEY に設定してタスクを送信します:
送信レスポンスの例:
返された id を保存し, 下記の TASK_ID に置き換えて結果を取得します:
タスクは pending, queued, in_progress を経て completed または failed になります. completed では result.data から画像 URL を, failed では error を読み取ります. 数秒ごとにポーリングしてください. 全フィールドは 画像タスクステータス API を参照してください. 送信成功はタスクが作成されたことのみを意味します. 画像のダウンロードは completed を待ち, 待機中は同じタスク ID をポーリングし続けてください.

リクエストパラメータ

string
必須
Bearer YOUR_TOAPIS_API_KEY で認証します.
string
必須
gpt-image-2.6-flare または gpt-image-2.6-sunburst.
string
必須
画像の説明. 参照画像を使う場合は, 残す対象と変更する内容を記述してください.
string
デフォルト:"high"
3 段階: low, medium, high. Playground のデフォルトは high. 省略時は上流のデフォルト値が使われます.
string
デフォルト:"1:1"
アスペクト比. 例: 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 21:9.size にアスペクト比を指定し, resolution を明示的に渡すことを推奨します. 出力ピクセル寸法は両方の値から計算されます.auto を渡して上流に寸法を任せることもできますが, 最終的なアスペクト比とピクセル寸法は保証されません.
string
デフォルト:"1K"
解像度ティア. 1K, 2K, 4K をサポート. 小文字も可. 標準ティアではこのフィールドが料金ティアを決定します.
integer
デフォルト:1
リクエストあたり 1 を指定し, 1 枚の画像を生成します.
string
オプションの背景設定. "transparent" で透明背景の画像を生成します. 通常の生成では省略してください.テキスト生成と reference_images を含むリクエストの両方で利用できます.
string
出力フォーマット: png, jpeg, webp, gif, svg. 省略時は上流のデフォルト. GIF と SVG の追加パラメータと制限は下記の各セクションを参照してください.
integer
デフォルト:9
GIF のみ. フレーム数 2〜64. テキスト生成 GIF ではこの値が適用されます. 画像から GIF への生成では常に 9 フレームで出力されます.
integer
デフォルト:200
GIF のみ. フレームあたりのミリ秒数 20〜2000 (10 刻み).
string[]
オプションの参照画像 URL リスト, 最大 10 枚. 画像はサーバーから到達可能である必要があります. URL のみ対応し, ローカルファイルや base64 は受け付けません. ローカル画像は先に 画像アップロード API で URL を取得してください.image_urls も使用できます. どちらか一方を指定してください."output_format": "gif" と組み合わせると, 画像から GIF への生成になります.

透明背景

生成リクエストに "background": "transparent" を加えると透明背景の画像が得られます. 通常の生成では省略してください.
タスクは通常どおりタスク ID で照会し, result.data から画像 URL を読み取ります.

GIF 出力

output_format を gif に設定するとアニメーションを生成します. frame_count がフレーム数 (2〜64, デフォルト 9), frame_duration_ms がフレームあたりの時間 (20〜2000 ミリ秒, 10 刻み, デフォルト 200) を制御します.

画像から GIF

reference_images を追加すると既存の画像をアニメーション化できます. 画像から GIF への出力は常に 9 フレームでレンダリングされ, frame_count はこのモードでは無視されますが, frame_duration_ms は有効です.

SVG 出力

output_format を svg に設定するとベクター画像を生成します. 追加フィールドは不要です.

比率と解像度の例

4K は解像度ティアであり, 実際の幅と高さはアスペクト比によって決まります. 例えば正方形の 4K 出力は 2880x2880 です.

参照画像による生成

同じ生成エンドポイントに reference_images を最大 10 枚まで追加します. 以下の例は Sunburst を使い, 非同期タスクを返します:
https://example.com/otter.png を実際の参照画像 URL に置き換え, 返されたタスク ID で結果を照会してください.

料金

標準ティアは生成画像 1 枚ごとの課金で, resolution ティアが料金ティアを決定します. GIF と SVG 出力も同じ 1 枚あたりの料金で課金されます. 参照画像の入力には現在追加料金はありません. アカウント固有の価格や割引が適用される場合があります. 最新の価格は モデル料金ページ とアカウント設定で確認してください.

関連モデル

GPT-Image-2.6 Official 版は公式チャネル経由で, 6 段階の品質, カスタムピクセルサイズ, マークアップガイド編集, トークン課金を提供します. そのチャネルでは -official サフィックス付きのモデル名を指定してください.