說明文件

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-flash
  • deepseek-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 OpenAI
2
 
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 提供。
  • 餘額與各模型用量可在儀表板查看;模型回應前就被拒絕的請求不會扣費。

開始使用

四個步驟送出第一個請求

  1. 01

    建立免費帳號

    使用 Google、GitHub 或 Email 與密碼註冊,無需綁定信用卡。

  2. 02

    產生 API Key

    在控制台一鍵產生,讓你的 CLI 通過 Code By AI 驗證。

  3. 03

    充值餘額

    首次請求前先充值,使用量會按 token 從餘額扣除。

  4. 04

    把 CLI 指向 Code By AI

    設定一個 base URL 環境變數,或在 config.toml 加入 model provider 區塊。各工具的接入指南都列出完整指令。

立即使用充值後送出請求看一個月實際要花多少

註冊無需綁卡 · 使用 API 前需先充值