用你自己的工具生圖
不需要寫程式碼。在你平常使用的工具中接上 GPT Image,就能直接生圖。
第 1 步:準備 Key
這一步在做什麼: Key 相當於你的帳號密碼,工具需要靠它來呼叫 OfoxAI。
- 開啟 OfoxAI 控制台 ,進入 Settings → API Keys,點選 Create New Key。
- 立即複製並妥善保存。Key 只會在建立時顯示一次,關閉後就無法再查看。
建議專門為這個工具建立一個 Key。日後不再使用或擔心外洩時,單獨刪除它即可,不會影響其他地方。
大約花費多少: 依品質計費。按 OpenAI 官方參考價,一張 1024×1024 的圖,最低品質不到 1 美分;gpt-image-2 的高品質約 21 美分。建議先用最低品質試用,滿意後再調高。詳見品質與價格。
Key 只填寫在工具的設定中,或填入編碼助手告訴你的檔案中。不要在聊天對話中傳送,也不要截圖分享給他人。
下一步: 判斷你的工具屬於哪一類。
第 2 步:判斷你的工具屬於哪一類
這一步在做什麼: 不同工具的接入方式不同,請先確認你的工具屬於哪一類。
常用工具對照(2026-09-30 查證):
若仍無法判斷:設定中有「新增服務商」「自訂 API」這類選項的,請依聊天、繪圖用戶端接入;平常是讓它幫你寫程式碼、執行任務的,請依AI 助手、編碼助手接入。
下一步: 跳到對應的方式。
聊天、繪圖用戶端
確認工具能夠生圖
這一步在做什麼: 確認你的工具能接入外部的生圖模型。並非所有工具都可以。
需要同時滿足以下兩點:
- 工具中有「繪畫」「生圖」「圖像生成」之類的入口。
- 這個入口中可以選擇你自行新增的服務商與模型。
有些工具的繪圖功能只能使用它自帶的模型,無法選擇你新增的服務商,這類工具無法接入 GPT Image。若不確定,請查閱工具本身的說明。若不滿足條件,請改用AI 助手、編碼助手的方式接入。
新增 OfoxAI 服務商
這一步在做什麼: 告訴工具要向哪裡發出請求、使用哪個 Key。
已經在這個工具中接過 OfoxAI 的聊天模型? 直接使用那個服務商,跳到下一步。
尚未接過? 請依工具的設定指南操作,其中每一步都附有截圖:Cherry Studio · LobeHub · 全部工具。關鍵的幾項如下:
OpenAI若沒有 OpenAI,請選擇「OpenAI 相容」https://api.ofox.io/v1個別工具(如 NextChat)需去掉結尾的 /v1,以該工具的設定指南為準使用 LobeHub 時請勿新建服務商。 LobeHub 中自行新增的模型無法設為圖像類型,需修改它內建的「OpenAI」服務商:
https://api.ofox.io/v1GPT Image 22.5 兩款尚未列入 LobeHub 的內建清單新增生圖模型
這一步在做什麼: 告訴工具要用哪個模型生圖。
在這個服務商下手動新增模型,複製以下其中一個模型 ID:
openai/gpt-image-2.5-flare日常生圖,出圖快,建議先使用這一款openai/gpt-image-2.5-sunburst改圖,更貼近原圖圖像生成Cherry Studio 中稱為「端點類型」,請選擇「影像產生(OpenAI)」;其他工具請選擇圖像生成類,不要選擇對話開始生圖
這一步在做什麼: 在生圖入口中選擇剛新增的模型,輸入描述,生成一張試試。
若工具中可以選擇「品質」,請先選低(low),確認能出圖後再調高。品質越高,費用越高、耗時越長,高品質可能需要等待數分鐘。
無法生成圖片?請見常見問題。
AI 助手、編碼助手
若尚未安裝編碼助手,請先依教學安裝:Claude Code、Codex、OpenClaw。
編碼助手可以幫你做兩件事,請依需要選擇其一:
- 直接幫我生圖:你用對話描述想要的圖,它生成後儲存到電腦上。
- 接入我正在開發的專案:例如你正在開發一個網站或小程式,希望它具備生圖功能。
將提示詞傳送給編碼助手
這一步在做什麼: 告訴編碼助手要做什麼、如何安全地完成。它會先帶你把 Key 存好,再開始工作。
依你的需要,複製其中一段,傳送給 Claude Code、Codex、ZCode、OpenClaw 或 WorkBuddy:
直接幫我生圖
想透過對話讓它幫你生成圖片時,請複製這一段。
我想用 OfoxAI 的 GPT Image 模型生成圖片。我已經在 OfoxAI 控制台建立好 API Key。我不太懂技術,請一步一步帶我完成,每一步先用淺白的話告訴我你在做什麼、下一步是什麼。 【第一步:幫我安全地保存 Key】 1. 在目前資料夾建立 .env 檔案,寫入一行 OFOX_API_KEY=,等號後面留空。如果目前資料夾是程式碼儲存庫,請把 .env 加入 .gitignore。 2. 告訴我這個檔案在哪裡、如何開啟,讓我自己把 Key 貼到等號後面並儲存。 3. 不要讓我把 Key 傳送在對話中。如果我不小心傳送了,請提醒我到控制台刪除這個 Key,再建立一個新的。 4. 等我告訴你「填好了」再繼續。 【第二步:準備生圖】 5. 寫一個小腳本,從 .env 讀取 OFOX_API_KEY,呼叫 POST https://api.ofox.io/v1/images/generations 生圖。 6. 模型使用 openai/gpt-image-2.5-flare,quality 使用 low,size 使用 1024x1024,用戶端逾時設定為 600 秒。 7. 回傳的 data[0].b64_json 是純 base64,解碼後儲存成 PNG,放在目前資料夾的 images 目錄中。 8. 不要把 Key 列印出來,也不要寫進腳本中。 【第三步:試生成一張】 9. 先生成一張「白色桌面上的一顆紅蘋果」,告訴我圖片儲存在哪裡、如何開啟。 10. 之後我每描述一張圖,你就用這個腳本生成一張,並告訴我儲存位置。想要更清晰時,我會說「品質高一點」,你再把 quality 改成 medium 或 high,並提醒我會更貴、更慢。 【出錯時】 11. 列印 HTTP 狀態碼與完整錯誤(包括 error.message 與 request_id),對照 https://ofox.io/zh-TW/docs/develop/models/gpt-image#errors 找出原因,只修改一處再試。 12. 同一個錯誤修改兩次仍未解決時,請停下來,用淺白的話告訴我發生了什麼問題,並把 request_id 與錯誤訊息原文給我,方便我聯絡 OfoxAI。 13. 一次只生成一張,不要自行批次重試(每次請求都會計費)。
接入我正在開發的專案
想讓你的網站、應用程式具備生圖功能時,請複製這一段。
我想在目前的專案中接入 OfoxAI 的 GPT Image 圖片生成。我已經在 OfoxAI 控制台建立好 API Key。我不太懂技術,請一步一步帶我完成,每一步先用淺白的話告訴我你在做什麼、下一步是什麼。 【第一步:幫我安全地保存 Key】 1. 在專案中建立 .env 檔案,寫入一行 OFOX_API_KEY=,等號後面留空。 2. 把 .env 加入 .gitignore,確保它不會被提交或上傳。 3. 告訴我這個檔案在哪裡、如何開啟,讓我自己把 Key 貼到等號後面並儲存。 4. 不要讓我把 Key 傳送在對話中。如果我不小心傳送了,請提醒我到控制台刪除這個 Key,再建立一個新的。 5. 等我告訴你「填好了」再繼續。 【第二步:撰寫程式碼】 6. 使用 OpenAI 官方 SDK 呼叫 OfoxAI 的圖片介面,base_url 為 https://api.ofox.io/v1,Key 從 .env 中的 OFOX_API_KEY 讀取。 - 文生圖:POST /v1/images/generations - 改圖、多圖融合、局部重繪:POST /v1/images/edits(multipart 上傳) 7. 模型 ID 寫完整:openai/gpt-image-2.5-flare(改圖使用 openai/gpt-image-2.5-sunburst)。 8. 明確傳入 quality,開發階段使用 low。不傳時模型會自行選擇檔位。 9. size 必須同時滿足:寬高都能被 16 整除、最長邊 ≤ 3840、寬高比在 1:3 到 3:1 之間、總像素 ≥ 655,360。 10. 結果位於 data[0].b64_json,是不帶 data: 前綴的純 base64,解碼後儲存成圖片檔案。 11. 用戶端逾時設定為 600 秒。 12. 不要傳入 response_format、input_fidelity、style。 13. 不要把 Key 寫進程式碼、日誌或錯誤訊息中;列印請求時請將 Authorization 標頭遮蔽。 【第三步:測試】 14. 使用 quality=low、size=1024x1024 實際呼叫一次,確認回傳 200、圖片能開啟,然後告訴我圖片儲存在哪裡。 15. 測試時一次只生成一張,不要撰寫迴圈批次測試(每次請求都會計費)。 【出錯時】 16. 列印 HTTP 狀態碼與完整回應主體(包括 error.message 與 request_id),對照 https://ofox.io/zh-TW/docs/develop/models/gpt-image#errors 找出原因。 17. 遇到 429 時稍等再重試;其他錯誤請先修改請求,不要原樣重試。 18. 同一個錯誤修改兩次仍未解決時,請停下來,用淺白的話告訴我發生了什麼問題,並把 request_id 與錯誤訊息原文給我,方便我聯絡 OfoxAI。 【上線前自我檢查】 19. 當我說「準備上線」時,逐項檢查並告訴我結果:程式碼與提交紀錄中沒有 Key;.env 已在 .gitignore 中;每個請求都傳入了 quality;逾時 ≥ 600 秒;出錯時會列印狀態碼、錯誤原文與 request_id。 參考文件: - 本系列取值與限制:https://ofox.io/zh-TW/docs/develop/models/gpt-image - 介面通用結構:https://ofox.io/zh-TW/docs/api/openai/images
依它的提示將 Key 填入檔案
這一步在做什麼: 讓 Key 只存在你電腦上的檔案中,不出現在對話裡。
編碼助手會告訴你 .env 檔案的位置。開啟它,將 Key 貼到 OFOX_API_KEY= 後面,儲存後回覆它「填好了」。
看它生成第一張圖
這一步在做什麼: 確認一切都已接好。
編碼助手會先生成一張測試圖,並告訴你儲存位置。能開啟就代表已接好,之後直接用對話告訴它你想要什麼圖即可。
這兩段提示詞幫你避開了哪些問題
出錯了怎麼辦
這一步在做什麼: 讓編碼助手自行查出原因並修正。大多數錯誤,它看到錯誤原文就能自行解決。
出錯時,將下面這段傳送給它:
排查提示詞
生圖出錯時傳送給編碼助手。
剛才生圖出錯了。請依序排查,並用淺白的話告訴我結果: 1. 列印這次請求的 HTTP 狀態碼與完整錯誤(Authorization 標頭需遮蔽)。 2. 閱讀 error.message,對照 https://ofox.io/zh-TW/docs/develop/models/gpt-image#errors 找出原因。 3. 只修改一處,使用 quality=low、size=1024x1024 重試一次。 4. 仍然失敗就停下來,告訴我發生了什麼問題,並把 request_id 與錯誤訊息原文給我。
仍無法解決時,聯絡 OfoxAI 請附上編碼助手提供給你的 request_id 與錯誤訊息,我們可以直接查到這次請求。請勿傳送 Key 本身。
常見問題
我的工具能用 GPT Image 生圖嗎?
聊天、繪圖用戶端需滿足兩點:有「繪畫」「生圖」入口,且這個入口能選擇你自行新增的服務商與模型。有些工具的繪圖功能只能使用它自帶的模型,這類工具無法接入。Claude Code、Codex、ZCode、OpenClaw 這類編碼助手都可以:把本頁的提示詞傳送給它,它會寫一個小腳本幫你生圖。
Cherry Studio 如何設定 GPT Image 繪畫?
在 Cherry Studio 中新增 OpenAI 類型的服務商,API 位址填寫 https://api.ofox.io/v1,並填入 Key。接著手動新增模型 openai/gpt-image-2.5-flare,新增時將「端點類型」選為「影像產生(OpenAI)」,模型才會出現在「繪畫」中。
LobeHub 能用 GPT Image 生圖嗎?
可以,但需使用 LobeHub 內建的 OpenAI 服務商:將 API 代理地址改為 https://api.ofox.io/v1,填入 Key,生圖時選擇 GPT Image 2。LobeHub 中自行新增的模型無法設為圖像類型,因此不要新建服務商。GPT Image 2.5 兩款尚未列入它的內建清單。
工具提示連線失敗或 404 該如何處理?
請先檢查三項:API 位址是否填寫 https://api.ofox.io/v1(少數工具如 NextChat 需去掉 /v1);Key 是否完整複製、沒有多餘空格;模型 ID 是否從文件原樣複製,大小寫都正確。
生成一張圖需要多少錢、多久?
依品質計費。按 OpenAI 官方參考價,一張 1024x1024 的圖,low 不到 1 美分,gpt-image-2 的 high 約 21 美分。生成耗時隨品質與尺寸而異,高品質可能需要數分鐘。實際扣費以每次請求的用量為準,OfoxAI 即時價格請見模型頁。建議先用 low 確認能出圖,再依需要調高。
不小心把 Key 傳送在對話中該怎麼辦?
到 OfoxAI 控制台刪除這個 Key,建立一個新的,再依上述說明填入工具設定或 .env 檔案。刪除之後,舊 Key 就無法再使用。