概要
このエンドポイントは、従来の OpenAI 互換 variation クライアント向けに保持されています。現在の image-to-image ワークフローでは推奨パスではありません。可能な場合は/v1/images/edits と gpt-image-2、または /v1/images/generations で nano-banana-pro などの image-to-image モデルを使用してください。multipart/form-data が必要です。
リクエストボディ
同期リクエストのタイムアウト: ルーティング先の画像プロバイダーによっては、生成完了まで待って最終画像をインラインで返します。高解像度または高品質のリクエストは 1 分前後、またはそれ以上かかることがあるため、HTTP クライアントのタイムアウトは少なくとも120s に設定してください。作成レスポンスに status: "pending"、task_id、または poll_url が含まれる場合は、返された poll_url をポーリングしてください。
file
必須
バリエーションの基となる画像。有効な PNG ファイルで、50MB 未満、正方形である必要があります。
string
必須
従来の variation 互換ルート向けの必須モデル ID。暗黙のデフォルトはありません。現在の image-to-image ワークフローでは、現在のモデルを使って
/v1/images/edits または /v1/images/generations を優先してください。integer
デフォルト:"1"
生成する画像の数。1 から 10 の間である必要があります。
string
従来の variation 互換ルートで生成される画像サイズ。サポートされる値は選択したモデルによって異なります。
string
デフォルト:"url"
生成された画像の返却形式。
url または b64_json である必要があります。string
不正利用監視のためのエンドユーザーの一意識別子。
レスポンス
integer
画像が作成された時の Unix タイムスタンプ。
array
生成された画像バリエーションの配列。各オブジェクトには以下が含まれます:
url(string): バリエーション画像の URL(response_format がurlの場合)b64_json(string): Base64 エンコードされた画像(response_format がb64_jsonの場合)
注意事項
これは従来互換のエンドポイントであり、現在の推奨画像モデルカタログには含まれません。新規連携では
/v1/images/edits と gpt-image-2、または /v1/images/generations で operation: "image-to-image" と現在の image-to-image モデルを使用してください。