メインコンテンツへスキップ
POST
GPT-Image-2.6 公式チャネルの画像生成
公式チャネル経由で 2 つの GPT-Image-2.6 モデルを利用できます. 送信すると非同期タスク ID がすぐに返ります. バックグラウンドで画像を生成し, R2 に保存してから提供します. 呼び出しには表の完全なモデル名を使ってください. gpt-image-2.6-official はシリーズ名であり, リクエストの model には使えません. 中国大陸のユーザーは例の https://api.toapis.com を https://api.toapis.cn に置き換えてください. コンソール で API Key を作成し, 環境変数 TOAPIS_API_KEY を設定します.

送信とポーリング

Flare で画像を送信します. Sunburst を呼ぶ場合は model を置き換えるだけです:
送信レスポンスの id を保存し, 下の TASK_ID をその値に置き換えます:
送信レスポンスは pending です. ポーリングでは queued や in_progress が表示され, 最終的に completed または failed になります. completed のとき result.data[].url から R2 に保存された結果 URL を取得し, failed のときは error を読みます. 同じタスク ID を数秒ごとにポーリングしてください. 高品質な生成には数分かかることがあるため, 待機中に再送信しないでください. 全フィールドは 画像タスクステータス API を参照してください.

リクエストパラメータ

string
必須
Bearer YOUR_API_KEY 形式の ToAPIs API Key を使用します.
string
必須
gpt-image-2.6-sunburst-official / gpt-image-2.6-flare-official.
string
必須
画像の説明. 参照画像やマークアップ画像を使う場合は, 保持する部分と変更する部分を記述してください.
string
デフォルト:"auto"
アスペクト比名 (1:1, 3:2, 2:3, 16:9, 9:16 など) またはピクセルサイズ (1024x1024, 1536x1024 など). GIF 出力時の size の意味は GIF の節を参照してください. ピクセルサイズは両辺が 16 の倍数かつ 16 以上, 各辺は 3840 以下, 長辺は短辺の 3 倍以内である必要があります. 2560x1440 を超えるサイズは実験的です.
string
解像度ティア 1k / 2k / 4k. 明示した場合は size から推測されるティアより優先されます. ティアは実際のトークン使用量と所要時間に影響します.
string
デフォルト:"medium"
auto, low, medium, high, xhigh, max の 6 段階. auto はリクエストごとにモデルが品質を自動選択します. 品質は実際のトークン使用量と所要時間に影響します.
integer
デフォルト:1
1 回のリクエストで 1〜4 枚生成します. output_format が svg の場合は 1 のみ指定できます.
string
出力形式 png / jpeg / webp / gif / svg. 省略時はアップストリームのデフォルトを使います. gif と svg の追加パラメータと制約は下の各セクションを参照してください.
integer
0-100 の圧縮率. jpeg と webp 出力にのみ有効です.
string
transparent / opaque / auto. 明示的な透明は png / webp 出力にのみ適用されます. svg はデフォルトで透明です.
string
コンテンツモデレーションレベル auto / low.
string
生成の複雑さ low / medium / high. 省略時は high になります. 別途課金はありません.

参照画像とマスク

画像から画像を生成する場合は同じ JSON リクエストに image_urls を追加します. 最大 16 枚で, URL はサーバーからアクセス可能である必要があります. 先に 画像アップロード API で URL を取得できます. 参照画像は画像入力トークンとして課金されます. mask_url は PNG アルファマスク画像を指し, サイズは最初の参照画像と一致している必要があり, image_urls と併用します.

マークアップ編集

markup_url は注釈付きの参照画像を指します (または markup でインラインの注釈オブジェクトを渡します). image_urls で元画像を指定し, モデルが注釈の意味に沿って編集します. markup_url と mask_url は排他的で, 1 回のリクエストではどちらか一方しか使えません.

GIF 出力

output_format に gif を指定するとアニメーションを生成します. frame_count でフレーム数 (2-16), frame_duration_ms でフレームごとの長さを指定します. GIF はテキストからの生成のみで, image_urls, mask_url, markup_url, markup, output_compression と併用できません. size は正確なピクセル値 (例: 512x512) を指定するか省略してアップストリームのデフォルトフレーム寸法を使ってください. 1:1 などのアスペクト比は GIF では拒否されます.

SVG 出力

output_format に svg を指定するとベクター画像を生成します. svg オブジェクトとその中の svg.model も必要です. SVG はテキストからの生成のみで, n は 1 のみ指定でき, image_urls, mask_url, markup_url, markup, output_compression と併用できません. SVG 生成では svg.model で指定したテキストモデルの呼び出しが追加で発生し, そのテキストモデルの料金で課金されます.

トークン料金

2 つの official モデルはトークン項目別に課金されます. テキスト入力, キャッシュされたテキスト入力, 画像入力, キャッシュされた画像入力, 画像出力がそれぞれ別料金です. 送信時にクォータが事前に引き落とされ, 成功後は実際のトークン使用量に応じて返金または追加課金されます. USD 単位の費用計算式:
GIF はアニメーション全体の出力トークンで課金されます. SVG 出力は画像トークンに加えて, svg.model で指定したテキストモデルの入出力トークン料金が発生します. アカウント固有の価格や割引は引き続き適用されます. 最終的な請求額は利用ログで確認でき, 最新の価格は 料金ページ とアカウント設定に従います.

関連モデル

GPT-Image-2.5 公式チャネル, 通常版, VIP 版 にはそれぞれ独自の完全なモデル名があります. この公式チャネルを呼び出すときは -official サフィックスを使ってください.