文生圖
用一段文字生成圖片。
不寫程式碼?請見用你自己的工具生圖。
開始之前
程式碼中會用到的值
API 位址
https://api.ofox.ai/v1模型 ID
openai/gpt-image-2.5-flareAPI Key將程式碼中的 YOUR_OFOX_API_KEY 換成你的 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常用調整
在上面的請求中修改一個參數即可:
尺寸(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/ 前綴寫完整。
常用
每張分別計費。超過 10 會回傳 400。
三種格式實測皆可用。
▶進階 · 4output_compression · background · moderation · partial_images展开
只對 jpeg 與 webp 生效。
透明背景需搭配 png 或 webp 使用,jpeg 不支援透明。
內容審核的嚴格程度。
搭配 stream: true 使用,表示生成過程中回傳幾張中間圖。
常見錯誤
其他錯誤請見完整錯誤表。
官方文件
OpenAI 官方文件描述的是直連 OpenAI 時的行為。在 OfoxAI 上呼叫時,以本系列文件的實測結論為準,例如改圖不需要指定供應商。
Last updated on