Skip to Content
模型用法GPT Image文生圖

文生圖

用一段文字生成圖片。

不寫程式碼?請見用你自己的工具生圖。

POST/v1/images/generations通用參數說明 試一試

開始之前

需要準備說明
API Key在 OfoxAI 控制台  建立,取代程式碼中的 YOUR_OFOX_API_KEY
執行環境cURL 需要安裝 jq 來解碼圖片;Python 需要 pip install openai;Node.js 18 以上,不需安裝相依套件
逾時用戶端逾時設定為 600 秒。高品質、大尺寸或改圖可能需要等待數分鐘
程式碼中會用到的值
API 位址https://api.ofox.ai/v1
模型 IDopenai/gpt-image-2.5-flare
API Key將程式碼中的 YOUR_OFOX_API_KEY 換成你的 Key
Python 相依套件pip install openai

範例程式碼

以下程式碼皆原樣執行通過,結果儲存為目前目錄下的 output.png。

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檔位越高越貴越慢,請見品質
更小的檔案output_format、output_compression改用 jpeg 或 webp,再調整壓縮率
一次多張n1–10 張,每張分別計費

尺寸(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/ 前綴寫完整。

常用
ninteger· 預設 1· 可選1–10

每張分別計費。超過 10 會回傳 400。

output_formatstring· 預設 png· 可選pngjpegwebp

三種格式實測皆可用。

▶進階 · 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 format透明背景搭配了 jpeg改用 png 或 webp
404 model_not_found模型 ID 拼錯或大小寫不正確從本頁複製模型 ID
Invalid size尺寸不滿足上述四項限制依尺寸與品質調整
does not support quality 'xhigh'對 gpt-image-2 傳入了 xhigh 或 max改用 high,或換用 2.5
Invalid value: 'standard'quality 傳入了 standard 或 hd改用 low 到 max
429 rate_limit_exceeded超過每分鐘 100 次(以團隊合計)稍後重試

其他錯誤請見完整錯誤表。

官方文件

OpenAI 官方文件描述的是直連 OpenAI 時的行為。在 OfoxAI 上呼叫時,以本系列文件的實測結論為準,例如改圖不需要指定供應商。

Last updated on