Skip to Content
モデルの使い方GPT Imageテキストから画像生成

テキストから画像生成

テキストのプロンプトから画像を生成します。

コードを書かない場合は、手持ちのツールで画像生成を参照してください。

始める前に

必要なもの詳細
API キーOfoxAI コンソール で作成し、コード内の YOUR_OFOX_API_KEY を置き換えてください
実行環境cURL では画像のデコードに jq が必要です。Python では pip install openai が必要です。Node.js は 18 以上で、依存パッケージは不要です
タイムアウトクライアントのタイムアウトを 600 秒に設定してください。高品質・大サイズ・編集では数分かかる場合があります
コードで使用する値
API URLhttps://api.ofox.io/v1
モデル IDopenai/gpt-image-2.5-flare
API キーコード内の YOUR_OFOX_API_KEY をご自身のキーに置き換えてください
Python の依存パッケージpip install openai

コード例

以下のコード例はすべてそのまま実行して動作を確認しています。結果はカレントディレクトリに output.png として保存されます。

Terminal
curl -s https://api.ofox.io/v1/images/generations \ -H "Authorization: Bearer YOUR_OFOX_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "openai/gpt-image-2.5-flare", "prompt": "白いテーブルの上の赤いリンゴ、柔らかな自然光", "size": "1024x1024", "quality": "low" }' \ -o response.json # 画像は base64 で返されるので、デコードして保存します(jq が必要。エラー時は response.json を確認) jq -r '.data[0].b64_json' response.json | base64 --decode > output.png

よく使う調整

上記のリクエストでパラメーターを 1 つ変更します。

目的変更するパラメーター補足
サイズを変えるsize任意のサイズは 4 つのルールを満たす必要があります
品質を上げるquality上位のティアほど料金が高く、時間もかかります。品質を参照
ファイルを小さくするoutput_format、output_compressionjpeg または webp に切り替えてから圧縮率を設定します
複数枚生成するn1〜10 枚、1 枚ごとに課金されます

サイズ(size)と品質(quality)

  • サイズ size:幅と高さはどちらも 16 の倍数、長辺 ≤ 3840、アスペクト比は 1:3 から 3:1 の範囲内、総ピクセル数 ≥ 655,360。768x768 はエラーになり、1024x768 は使用できます。省略するとモデルが決定し、実測では 1254×1254 でした。サイズを参照してください。
  • 品質 quality:まず low で動作を確認してから上げてください。省略は medium と同じではなく、モデルがティアを決定します。gpt-image-2 には xhigh と max がありません。ティアごとの使用量は品質を参照してください。

パラメーターの値

このファミリーにおける有効な値と実測のデフォルト値です。size と quality については、概要ページのサイズと品質を参照してください。

必須
model必須string· 有効な値openai/gpt-image-2.5-flareopenai/gpt-image-2.5-sunburstopenai/gpt-image-2

大文字と小文字を区別します。誤っていると 404 を返します。openai/ プレフィックスを含む完全な ID を指定してください。

よく使うパラメーター
ninteger· デフォルト 1· 有効な値1–10

1 枚ごとに課金されます。10 を超えると 400 を返します。

output_formatstring· デフォルト png· 有効な値pngjpegwebp

3 つとも動作を確認済みです。

▶高度な設定 · 4output_compression · background · moderation · partial_images展开
output_compressioninteger· 有効な値0–100

jpeg と webp にのみ適用されます。

backgroundstring· デフォルト opaque· 有効な値opaquetransparentauto

透明背景には png または webp が必要です。jpeg は透過に対応していません。

moderationstring· 有効な値autolow

コンテンツ審査の厳しさです。

partial_imagesinteger· 有効な値0–3

stream: true と併用します。生成中に送信する途中経過の画像の枚数です。

よくあるエラー

エラー原因対処法
moderation_blockedプロンプトが上流の安全システムでブロックされたプロンプトを変更して再試行してください。そのまま再試行しても結果は変わりません
Transparent background is not supported for JPEG output formatjpeg で透明背景を指定したpng または webp を使用してください
404 model_not_foundモデル ID のスペルミスまたは大文字・小文字の誤りこのページからモデル ID をコピーしてください
Invalid sizeサイズが上記 4 つのルールのいずれかに違反しているサイズと品質に従って調整してください
does not support quality 'xhigh'gpt-image-2 に xhigh または max を送信したhigh を使うか、2.5 に切り替えてください
Invalid value: 'standard'quality に standard または hd を指定したlow〜max を使用してください
429 rate_limit_exceeded1 分あたり 100 リクエスト(チーム単位)を超えた時間をおいて再試行してください

その他のエラーはエラー一覧を参照してください。

公式ドキュメント

OpenAI のドキュメントは、OpenAI に直接呼び出した場合の動作を説明しています。OfoxAI 経由で呼び出す場合は、このシリーズの実測結果が優先されます。たとえば、編集時にプロバイダーを指定する必要はありません。

Last updated on