Skip to Content
模型用法GPT Image用你自己的工具生圖準備 Key

用你自己的工具生圖

不需要寫程式碼。在你平常使用的工具中接上 GPT Image,就能直接生圖。

第 1 步:準備 Key

這一步在做什麼: Key 相當於你的帳號密碼,工具需要靠它來呼叫 OfoxAI。

  1. 開啟 OfoxAI 控制台 ,進入 Settings → API Keys,點選 Create New Key。
  2. 立即複製並妥善保存。Key 只會在建立時顯示一次,關閉後就無法再查看。

建議專門為這個工具建立一個 Key。日後不再使用或擔心外洩時,單獨刪除它即可,不會影響其他地方。

大約花費多少: 依品質計費。按 OpenAI 官方參考價,一張 1024×1024 的圖,最低品質不到 1 美分;gpt-image-2 的高品質約 21 美分。建議先用最低品質試用,滿意後再調高。詳見品質與價格。

Key 只填寫在工具的設定中,或填入編碼助手告訴你的檔案中。不要在聊天對話中傳送,也不要截圖分享給他人。

下一步: 判斷你的工具屬於哪一類。

第 2 步:判斷你的工具屬於哪一類

這一步在做什麼: 不同工具的接入方式不同,請先確認你的工具屬於哪一類。

你的工具例子接入方式
聊天、繪圖用戶端:有操作介面,可以自行新增模型服務商Cherry Studio、LobeHub 等在設定中填寫幾項設定
AI 助手 / 編碼助手:透過對話讓它幫你寫程式碼、操作電腦Claude Code、Codex、ZCode、OpenClaw、WorkBuddy 等複製一段提示詞傳送給它

常用工具對照(2026-09-30 查證):

工具接入方式
Cherry Studio聊天、繪圖用戶端。新增模型時,將「端點類型」選為「影像產生(OpenAI)」,模型才會出現在「繪畫」中。接入服務商的步驟請見 Cherry Studio 設定
LobeHub聊天、繪圖用戶端,但需使用它內建的「OpenAI」服務商。 LobeHub 中自行新增的模型無法設為圖像類型,因此不要新建服務商:在內建的 OpenAI 服務商中將 API 代理地址改為 https://api.ofox.io/v1、填入 Key,生圖時選擇 GPT Image 2。2.5 兩款尚未列入它的內建清單
Chatbox暫時無法使用。 它的生圖功能目前只能使用 Chatbox 自己的服務,無法接入外部服務商
WorkBuddyAI 助手、編碼助手。 它的模型設定只能接入對話模型,請先依 WorkBuddy 設定 接好,再將下方的提示詞傳送給它
Claude Code、Codex、ZCode、OpenClawAI 助手、編碼助手。 直接將下方的提示詞傳送給它

若仍無法判斷:設定中有「新增服務商」「自訂 API」這類選項的,請依聊天、繪圖用戶端接入;平常是讓它幫你寫程式碼、執行任務的,請依AI 助手、編碼助手接入。

下一步: 跳到對應的方式。

聊天、繪圖用戶端

確認工具能夠生圖

這一步在做什麼: 確認你的工具能接入外部的生圖模型。並非所有工具都可以。

需要同時滿足以下兩點:

  • 工具中有「繪畫」「生圖」「圖像生成」之類的入口。
  • 這個入口中可以選擇你自行新增的服務商與模型。

有些工具的繪圖功能只能使用它自帶的模型,無法選擇你新增的服務商,這類工具無法接入 GPT Image。若不確定,請查閱工具本身的說明。若不滿足條件,請改用AI 助手、編碼助手的方式接入。

新增 OfoxAI 服務商

這一步在做什麼: 告訴工具要向哪裡發出請求、使用哪個 Key。

已經在這個工具中接過 OfoxAI 的聊天模型? 直接使用那個服務商,跳到下一步。

尚未接過? 請依工具的設定指南操作,其中每一步都附有截圖:Cherry Studio · LobeHub · 全部工具。關鍵的幾項如下:

新增服務商時填寫以下內容
服務商類型OpenAI若沒有 OpenAI,請選擇「OpenAI 相容」
API 位址https://api.ofox.io/v1個別工具(如 NextChat)需去掉結尾的 /v1,以該工具的設定指南為準
API Key貼上第 1 步複製的 Key

使用 LobeHub 時請勿新建服務商。 LobeHub 中自行新增的模型無法設為圖像類型,需修改它內建的「OpenAI」服務商:

LobeHub:在內建的 OpenAI 服務商中填寫
API 代理地址https://api.ofox.io/v1
API Key貼上第 1 步複製的 Key
生圖時選擇GPT Image 22.5 兩款尚未列入 LobeHub 的內建清單

新增生圖模型

這一步在做什麼: 告訴工具要用哪個模型生圖。

在這個服務商下手動新增模型,複製以下其中一個模型 ID:

新增模型時填寫以下內容
模型 IDopenai/gpt-image-2.5-flare日常生圖,出圖快,建議先使用這一款
模型 IDopenai/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= 後面,儲存後回覆它「填好了」。

看它生成第一張圖

這一步在做什麼: 確認一切都已接好。

編碼助手會先生成一張測試圖,並告訴你儲存位置。能開啟就代表已接好,之後直接用對話告訴它你想要什麼圖即可。

這兩段提示詞幫你避開了哪些問題

要求不寫會怎樣
Key 放在 .env,不傳送在對話中Key 可能被寫進程式碼、上傳到網路上
模型 ID 從文件複製大小寫寫錯會回傳 404
預設使用 low 品質模型自行選擇檔位,品質與費用不穩定
逾時 600 秒高品質可能需要數分鐘,提前中斷會遺失圖片,但仍會計費
列印完整錯誤編碼助手只看到「請求失敗」,只能猜測原因
兩次不成功就停止編碼助手反覆重試,每次都在花錢

出錯了怎麼辦

這一步在做什麼: 讓編碼助手自行查出原因並修正。大多數錯誤,它看到錯誤原文就能自行解決。

出錯時,將下面這段傳送給它:

排查提示詞

生圖出錯時傳送給編碼助手。

剛才生圖出錯了。請依序排查,並用淺白的話告訴我結果:
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 就無法再使用。

Last updated on