模型名稱和能力會變化。開始前必須在 BearLab 模型廣場確認目標模型目前存在,並明確支援 OpenAI Images API;不要假定某個 gpt-image-* 名稱永久可用。

1. 建立繪圖專用金鑰

  1. 在 BearLab 模型廣場搜尋目標 OpenAI Images 相容模型。
  2. 記錄完整模型 ID 和所屬分組。
  3. 建立 API 金鑰,分組選擇包含該模型的分組。
  4. 儲存後複製金鑰。
BearLab 建立繪圖 API 金鑰

建立繪圖專用金鑰並核對分組

2. 先確認呼叫端點

OpenAI Images 相容模型應使用:
  • 文生圖:POST https://bearlab.ai/v1/images/generations
  • 圖片編輯:POST https://bearlab.ai/v1/images/edits
不要用 /v1/responses/v1/chat/completions 代替 Images API。

文生圖最小請求

先只傳 modelpromptn: 1。成功後再逐項加入模型明確支援的 sizequality 或輸出格式。

圖片編輯最小請求

/images/generations 成功而 /images/edits 失敗,通常說明該模型或目前線路不支援圖片編輯介面。請更換主控臺中明確支援圖片編輯的模型或分組後重試。

3. 安裝並開啟 Cherry Studio

  1. Cherry Studio 官網 下載並安裝軟體。
  2. 點擊 設定 → 模型服務
  3. 點擊列表底部的 新增
Cherry Studio 首次啟動頁面

首次啟動 Cherry Studio,選擇“設定其他服務商”

4. 新增 BearLab 服務商

填寫:
點擊 確定,再在服務商頁面填寫:
亞太線路使用 https://bearlab.space。New API 類型會自動拼接相容端點,無需手動補 /v1
Cherry Studio 設定 BearLab API 位址和掩碼金鑰

BearLab 服務商名稱、掩碼金鑰和 API 位址

5. 取得模型列表

  1. 點擊 取得模型列表
  2. 搜尋第 1 步記錄的準確模型 ID。
  3. 新增模型並回傳服務商設定頁。
  4. 確認模型已經顯示後儲存服務商。
Cherry Studio 從 BearLab 取得圖片模型列表

使用者端已從 BearLab 真實取得模型列表;先篩選“圖片”再核對準確模型 ID

如果列表沒有目標 OpenAI Images 模型,請回到 BearLab 核對模型開放狀態和令牌分組,不要手動填寫一個目前令牌不可用的模型 ID。

6. 設定模型端點類型

  1. 點擊該模型右側的編輯按鈕。
  2. 端點類型 設定為 圖像產生(OpenAI)
  3. 點擊 儲存
這是關鍵步驟;保持普通聊天端點會把請求傳送到錯誤介面。

7. 開啟繪畫應用

  1. 回到首頁,點擊頂部的 +
  2. 在應用列表中選擇 繪畫
  3. 服務商選擇 BearLab AI Images
  4. 模型選擇剛新增的模型。
  5. 首次使用把圖片尺寸、質量和敏感度保持為 自動,產生數量保持 1

8. 文生圖與圖片編輯

  • 文生圖:頂部選擇 繪圖,輸入提示詞後傳送。
  • 圖片編輯:切換到 編輯,在左側上傳輸入圖片,再填寫修改要求併傳送。
產生完成後,在 BearLab 消費日誌中核對模型 ID、請求狀態、耗時和扣費記錄。

9. 長連接與代理

圖片產生通常比普通聊天耗時更久。出現約一分鐘後中斷、Failed to fetch 或 HTML 被當作 JSON 解析時:
  1. 檢查本機代理是否限制長連接。
  2. bearlab.ai(亞太線路為 bearlab.space)加入直連或白名單。
  3. 保持 n: 1,尺寸和質量先用自動。
  4. 刪除可選參數後重試。
  5. 再根據 BearLab 請求日誌和請求 ID 定位服務端錯誤。

排錯順序

  1. 用同一金鑰確認 /v1/models 中存在目標模型。
  2. 用最小 /v1/images/generations 請求驗證服務端能力。
  3. 檢查 Cherry Studio 端點類型是否為 圖像產生(OpenAI)
  4. 刪除可選尺寸、質量和格式參數後重試。
  5. 根據 401/403/404/429/5xx、請求 ID 和消費日誌定位問題。