テキストから画像生成
テキストのプロンプトから画像を生成します。
コードを書かない場合は、手持ちのツールで画像生成を参照してください。
始める前に
コードで使用する値
API URL
https://api.ofox.ai/v1モデル ID
openai/gpt-image-2.5-flareAPI キーコード内の YOUR_OFOX_API_KEY をご自身のキーに置き換えてください
Python の依存パッケージ
pip install openaiコード例
以下のコード例はすべてそのまま実行して動作を確認しています。結果はカレントディレクトリに output.png として保存されます。
cURL
Terminal
curl -s https://api.ofox.ai/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)と品質(quality)
- サイズ
size:幅と高さはどちらも 16 の倍数、長辺 ≤ 3840、アスペクト比は 1:3 から 3:1 の範囲内、総ピクセル数 ≥ 655,360。768x768はエラーになり、1024x768は使用できます。省略するとモデルが決定し、実測では 1254×1254 でした。サイズを参照してください。 - 品質
quality:まずlowで動作を確認してから上げてください。省略はmediumと同じではなく、モデルがティアを決定します。gpt-image-2にはxhighとmaxがありません。ティアごとの使用量は品質を参照してください。
パラメーターの値
このファミリーにおける有効な値と実測のデフォルト値です。size と quality については、概要ページのサイズと品質を参照してください。
必須
大文字と小文字を区別します。誤っていると 404 を返します。openai/ プレフィックスを含む完全な ID を指定してください。
よく使うパラメーター
1 枚ごとに課金されます。10 を超えると 400 を返します。
3 つとも動作を確認済みです。
▶高度な設定 · 4output_compression · background · moderation · partial_images展开
jpeg と webp にのみ適用されます。
透明背景には png または webp が必要です。jpeg は透過に対応していません。
コンテンツ審査の厳しさです。
stream: true と併用します。生成中に送信する途中経過の画像の枚数です。
よくあるエラー
その他のエラーはエラー一覧を参照してください。
公式ドキュメント
OpenAI のドキュメントは、OpenAI に直接呼び出した場合の動作を説明しています。OfoxAI 経由で呼び出す場合は、このシリーズの実測結果が優先されます。たとえば、編集時にプロバイダーを指定する必要はありません。
Last updated on