DeepSeek 設定
本指南需要一組 API Key
註冊帳號並在約一分鐘內產生 API Key,再填入下方步驟中需要 API Key 的位置。
註冊無需綁卡 · 使用 API 前需先充值
DeepSeek 模型可透過 Code By AI 的 OpenAI 相容 Chat Completions 端點使用。將任何 OpenAI SDK 或相容用戶端的 base URL 指向本站,使用 Code By AI API Key,並在每次請求中明確指定 DeepSeek 模型 ID。
模型與價格
deepseek-v4.1-flashdeepseek-v4-pro
兩款模型都不是渠道預設值,因此每次請求都必須明確指定 ID。最新的輸入、快取命中與輸出費率請見 DeepSeek 價格頁。全天採用離峰(谷價)費率,沒有尖峰加價。
設定環境變數
以下兩個變數供 OpenAI 相容用戶端讀取。API Key 請在 API Keys 頁面建立。
macOS 或 Linux
將以下內容加入 ~/.zshrc(zsh)或 ~/.bashrc(bash),儲存後執行 source:
1 export OPENAI_BASE_URL="https://www.codebyai.net/api/agent"2 export OPENAI_API_KEY="sk-proj-xxxx"
Windows
在命令提示字元中為目前使用者設定相同變數:
1 setx OPENAI_BASE_URL "https://www.codebyai.net/api/agent"2 setx OPENAI_API_KEY "sk-proj-xxxx"
執行 setx 後請開新終端機,讓用戶端讀到新值。
傳送 Chat Completions 請求
用戶端必須使用 OpenAI 相容的 Chat Completions。/api/agent/v1/chat/completions 與 /api/agent/chat/completions 都會轉送:
1 curl --fail-with-body "https://www.codebyai.net/api/agent/v1/chat/completions" \2 -H "Authorization: Bearer $OPENAI_API_KEY" \3 -H "content-type: application/json" \4 -d '{5 "model": "deepseek-v4.1-flash",6 "messages": [{ "role": "user", "content": "Hello" }]7 }'
改用較大的模型時,將模型 ID 換成 deepseek-v4-pro。Responses 端點不提供 DeepSeek;省略 model 也不會選到 DeepSeek 模型。
使用 OpenAI SDK
官方 SDK 會讀取上方設定的 OPENAI_BASE_URL 與 OPENAI_API_KEY 環境變數。每次呼叫都要帶模型 ID:
1 from openai import OpenAI2 3 client = OpenAI()4 response = client.chat.completions.create(5 model="deepseek-v4.1-flash",6 messages=[{"role": "user", "content": "Hello"}],7 )8 print(response.choices[0].message.content)
疑難排解
- 若收到
403與Invalid key,代表金鑰無效、已撤銷或已過期。請檢查OPENAI_API_KEY,並確認Authorization標頭以Bearer權杖傳送金鑰。 400 Unknown model表示 ID 不在目錄中。請完整使用deepseek-v4.1-flash或deepseek-v4-pro。- 在
/v1/responses收到400是正常現象:DeepSeek 只透過 Chat Completions 提供。 - 餘額與各模型用量可在儀表板查看;模型回應前就被拒絕的請求不會扣費。
開始使用
四個步驟送出第一個請求
- 01
建立免費帳號
使用 Google、GitHub 或 Email 與密碼註冊,無需綁定信用卡。
- 02
產生 API Key
在控制台一鍵產生,讓你的 CLI 通過 Code By AI 驗證。
- 03
充值餘額
首次請求前先充值,使用量會按 token 從餘額扣除。
- 04
把 CLI 指向 Code By AI
設定一個 base URL 環境變數,或在 config.toml 加入 model provider 區塊。各工具的接入指南都列出完整指令。