gpt-image-2 APIとは?
1つのエンドポイント、Bearer認証、ホスト型出力。追加の配線は一切不要です。
gpt-image-2 APIは、promptと最大4枚のreference imagesを本番投入可能なPNGに変換するREST surfaceです。Bearer token付きで/api/v1/images/generateにPOSTするとtask_idが返り、/api/v1/images/task/[id]をpollして完了を待ちます。すべてのレスポンスはJSON形式で、2xxでは成功エンベロープ、4xxおよび5xxでは安定したエラーコードとrequest_idを含むエラーエンベロープが返されます。各レンダリング結果はR2 CDNに保存されHTTPSで配信されるため、URLをそのままhotlinkすることも、自前のバケットへmirrorすることも可能です。クレジットは投入時にアトミックに差し引かれ、タスクが失敗した場合は自動的に返還されるため、請求が実出力から乖離することはありません。surfaceはユーザー単位で分離されており、keyは所属アカウントのクレジット残高を継承し、プログラム経由で作成されたタスクのみ参照可能です(Web studio上のタスクは見えません)。送信データはすべてJSONで、multipartアップロード、SDKロックイン、隠れリトライは一切ありません。