入門
在軟體裡使用
不用寫程式碼，就能在你已經在用的軟體裡使用你的金鑰。選好軟體、複製設定，就完成了。這裡的步驟適用於 GPT 模型。
#1. 選擇你的軟體
聊天和翻譯軟體
程式設計工具
自己寫程式碼
#2. 複製設定
Cherry Studio
開啟：設定 → 模型服務 → OpenAI
"API Host" 會自動補 /v1/chat/completions。填到 host 或 /v1 為止即可；末尾加 # 可以關掉自動補全。
保護好 API 金鑰
請將金鑰儲存在環境變數或金鑰管理服務中，絕不要把長期金鑰放進瀏覽器程式碼、截圖或程式碼儲存庫。
#3. 確認能不能用
- 在軟體裡選好模型，傳送一句簡短的訊息，例如「你好」。
- 有回覆就說明連上了，這次呼叫會出現在控制台 → 用量裡。
- 如果軟體提示金鑰不對，看看它要的網址帶不帶 /v1。
#MCP 工具
模型連線與 MCP 是兩套獨立設定
aisplice 負責模型連線，MCP 伺服器負責外部工具和資料。在 Codex、Cursor 或其他客戶端裡分別設定 aisplice 和每個 MCP 伺服器。
在 Codex 中，可透過命令列新增遠端 MCP Server，也可以把對應設定寫入 ~/.codex/config.toml：
Codex MCP
# CLI
codex mcp add my-tools --url https://mcp.example.com/mcp
# equivalent ~/.codex/config.toml
[mcp_servers.my-tools]
url = "https://mcp.example.com/mcp"MCP 需要單獨認證
aisplice API 金鑰只用於認證模型請求。MCP 的 OAuth、請求標頭或環境變數請依照對應供應商的說明設定，完成後重新啟動客戶端使其重新載入設定。
#從 OpenAI SDK 遷移
#兩行 diff
對大多數專案而言，這就是整個 PR。傳輸格式與 OpenAI 相容，因此串流、工具呼叫、視覺、結構化輸出等能力都能用現有程式碼繼續運作。
const client = new OpenAI({- baseURL: "https://api.openai.com/v1",+ baseURL: "https://www.aisplice.store/v1",- apiKey: process.env.OPENAI_API_KEY,+ apiKey: process.env.GATEWAY_API_KEY,});
還是沒解決？
把請求 ID 或錯誤訊息傳給我們，我們來查。