ToAPIsToAPIs

集成指南

中國大陸用戶請注意: 中國大陸用戶請使用 https://toapis.cn 作為接口地址(Base URL)。文檔示例中的 https://toapis.com 請替換為 https://toapis.cn。

準備工作

在開始之前,請確保:

  1. 已安裝 ChatBox

    從 ChatBox GitHub 下載並安裝適合您操作系統的版本,或訪問 ChatBox 官網

  2. 已獲取 ToAPIs API 密鑰

    登錄 ToAPIs 控制檯 獲取您的 API 密鑰(以 sk- 開頭)

提示: 如果還沒有 ToAPIs 賬戶,請先在 ToAPIs 註冊並獲取 API 密鑰。

第一步:啓動 ChatBox 並開始配置

首次啓動 ChatBox 或添加新的 AI 提供商時:

  1. 啓動 ChatBox 應用
  2. 如果是首次使用,會自動彈出配置嚮導
  3. 點擊 “使用自己的 API Key 或本地模型” 按鈕
  4. 如果已經配置過,可以點擊左下角的 ⚙️ 設置 圖標,或使用快捷鍵 Ctrl+, (Windows/Linux) / Cmd+, (macOS)

ChatBox 啓動配置嚮導

第二步:配置 ToAPIs API

2.1 選擇 AI 模型提供商

在設置頁面中:

  1. 找到 AI 模型提供商 或 AI Provider 設置項
  2. 在下拉菜單中選擇 OpenAI API(使用 GPT 系列模型)、Claude API(使用 Claude 系列模型)或 Gemini API(使用 Gemini 系列模型)

ChatBox 設置頁面

2.2 配置 API 信息

選擇 OpenAI API 後,填寫以下配置信息:

配置項填寫內容
API Key您的 ToAPIs API 密鑰(sk-xxxxxxxxxxxx)
API Host 或 API Domainhttps://toapis.com

API 配置 選擇 Claude API 後,填寫以下配置信息:

配置項填寫內容
API Key您的 ToAPIs API 密鑰(sk-xxxxxxxxxxxx)
API Host 或 API Domainhttps://toapis.com/v1

claude模型 選擇 Gemini API 後,填寫以下配置信息:

配置項填寫內容
API Key您的 ToAPIs API 密鑰(sk-xxxxxxxxxxxx)
API Host 或 API Domainhttps://toapis.com/

Gemini 重要提示:

  • 使用 OpenAI API 時,API Host 應填寫 https://toapis.com(不包含 /v1 後綴)
  • 使用 Claude API 時,API Host 應填寫 https://toapis.com/v1(包含 /v1 後綴)
  • 使用 Gemini API 時,API Host 應填寫 https://toapis.com/(不包含 /v1 後綴)
  • API Key 必須是從 ToAPIs 控制檯獲取的以 sk- 開頭的密鑰
  • 確保您的 API 密鑰有足夠的餘額

2.3 選擇模型

配置完成後,在 模型 或 Model 下拉菜單中選擇您要使用的模型: 推薦模型:

模型名稱模型 ID特點
GPT-5gpt-5最新最強大的模型
GPT-4ogpt-4o 或 chatgpt-4o-latest高質量對話
GPT-4o Minigpt-4o-mini快速且經濟
Claude Sonnet 4.5claude-sonnet-4-5-20250929擅長代碼和推理
Claude Haiku 4.5claude-haiku-4-5-20251001快速響應
Gemini 2.0 Flashgemini-2.0-flash-exp多模態支持

**使用 Claude 模型的特殊說明:**如果您選擇使用 Claude 模型(如 claude-sonnet-4-5-20250929 或 claude-haiku-4-5-20251001),需要進行以下額外配置:

  1. 切換到 Claude API 提供商:
    • 在設置中將 AI 模型提供商 改爲 Claude API
    • API Host 保持填寫 https://toapis.com/v1
    • API Key 使用您的 ToAPIs API 密鑰(sk-xxxxxxxxxxxx)
  2. 或者添加自定義請求頭(如果使用 OpenAI API 提供商):
    • 某些版本的 ChatBox 支持添加自定義 Headers
    • 在高級設置中添加請求頭:anthropic-version: 2023-06-01

推薦方式: 使用 GPT 系列模型時選擇 OpenAI API,使用 Claude 系列模型時選擇 Claude API,使用 Gemini 系列模型時選擇 Gemini API。 性能建議:

  • 💰 高性價比: gpt-4o-mini、claude-haiku-4-5-20251001
  • 🚀 高性能: gpt-5、gpt-4o、claude-sonnet-4-5-20250929
  • ⚡ 快速響應: gemini-2.0-flash-exp、gpt-4o-mini

第三步:開始使用

配置完成後,您就可以開始使用 ChatBox 與 AI 對話了:

  1. 返回主界面
  2. 在輸入框中輸入您的問題或需求
  3. 按 Enter 或點擊發送按鈕
  4. AI 將使用 ToAPIs 的模型爲您生成回覆

對話界面

調整模型參數(可選)

您可以根據需要調整以下參數:

參數說明推薦值
Temperature控制輸出隨機性0.7(創意)/ 0.3(精確)
Max Tokens最大輸出長度2000-4000
Top P核採樣參數0.9

高級功能

多會話管理

ChatBox 支持創建多個對話會話:

  1. 點擊 新建對話 按鈕
  2. 可以爲不同的任務創建獨立的會話
  3. 在左側會話列表中切換不同的對話

保存和導出對話

  1. 右鍵點擊對話會話
  2. 選擇 導出 選項
  3. 可以導出爲 Markdown、JSON 等格式

使用提示詞模板

  1. 在設置中找到 提示詞 或 Prompts 設置
  2. 可以保存常用的提示詞模板
  3. 在對話中快速調用預設的提示詞

常見問題

Q1: 無法連接到 ToAPIs 服務?

解決方案:

  1. 檢查 API Host:
    • 確保填寫的是 https://toapis.com
    • 不要添加 /v1 或其他路徑
  2. 驗證 API Key:
    • 確認 API Key 正確且以 sk- 開頭
    • 在 ToAPIs 控制檯 檢查密鑰是否有效
  3. 檢查網絡連接:
    • 確保能夠訪問 https://toapis.com
    • 如果在國內,可能需要配置代理

Q2: 模型列表中沒有顯示 ToAPIs 的模型?

解決方案:

  1. 手動輸入模型名稱:
    • 在模型輸入框中直接輸入模型 ID
    • 例如:gpt-4o、gpt-4o-mini、claude-sonnet-4-5-20250929
  2. 刷新模型列表:
    • 重啓 ChatBox 應用
    • 重新配置 API 信息

Q3: 對話時出現錯誤提示?

常見錯誤及解決方案:

錯誤信息原因解決方法
401 UnauthorizedAPI Key 無效或過期重新獲取 API Key 並更新配置
429 Too Many Requests請求頻率超限稍等片刻後重試
500 Internal Server Error服務器臨時故障等待幾分鐘後重試
insufficient_quota賬戶餘額不足前往控制檯充值

Q4: 如何查看 API 使用情況和費用?

登錄 ToAPIs 控制檯 查看:

  • 📊 API 調用統計
  • 💰 費用明細
  • 📈 使用趨勢圖表
  • 🔍 詳細的請求日誌

Q5: ChatBox 支持哪些平臺?

ChatBox 支持多個平臺:

  • 🪟 Windows - Windows 10/11
  • 🍎 macOS - macOS 10.15+
  • 🐧 Linux - 各主流發行版
  • 🌐 Web - 瀏覽器版本

使用技巧

1. 快捷鍵

充分利用 ChatBox 的快捷鍵提升效率:

快捷鍵功能
Ctrl/Cmd + Enter發送消息
Ctrl/Cmd + N新建對話
Ctrl/Cmd + K搜索對話
Ctrl/Cmd + ,打開設置
Ctrl/Cmd + /顯示快捷鍵幫助

2. 優化提示詞

編寫更好的提示詞以獲得更好的回覆: ❌ 不好的提示: 複製

幫我寫代碼

✅ 好的提示: 複製

請幫我用 Python 編寫一個函數,實現以下功能:
1. 接收一個字符串列表作爲輸入
2. 過濾掉長度小於 3 的字符串
3. 返回按字母順序排序的結果
請包含詳細註釋和示例用法

3. 利用對話歷史

ChatBox 會保存對話歷史:

  • AI 會記住當前會話中的上下文
  • 可以基於之前的回答繼續提問
  • 適合進行深入的探討和迭代

4. 切換模型

根據不同任務切換合適的模型:

  • 寫作任務 - 使用 gpt-4o 或 claude-sonnet-4-5
  • 代碼任務 - 使用 claude-sonnet-4-5
  • 快速問答 - 使用 gpt-4o-mini
  • 多模態 - 使用 gemini-2.0-flash-exp

功能特性

使用 ChatBox + ToAPIs,您可以:

  • 💬 流暢對話 - 實時流式輸出,體驗更流暢
  • 🎯 多會話管理 - 同時管理多個獨立對話
  • 💾 本地存儲 - 對話記錄保存在本地,保護隱私
  • 📤 導出對話 - 支持多種格式導出對話記錄
  • 🎨 界面簡潔 - 簡潔美觀的用戶界面
  • 🔒 開源免費 - 完全開源,免費使用
  • 🌍 跨平臺 - 支持 Windows、macOS、Linux
  • 🚀 性能優秀 - 輕量級應用,運行流暢

支持與幫助

如果您在使用過程中遇到任何問題:


On this page