快速開始

讓新手依序完成 AIXHUB 登入、API Key、模型 ID、測試請求與客戶端選擇。

這一頁只做一件事：先確認你的 AIXHUB 帳戶、API Key、Base URL 和模型 ID 都可用。這一步成功後，再去設定 Claude Code、Codex CLI 或其他工具，排錯會簡單很多。

前置條件

可以登入 AIXHUB 控制台。
已經準備好一把 AIXHUB API Key，或知道如何到「API Key」頁面建立。
知道自己要使用哪一種協定：Claude Code 通常用 Anthropic 相容協定；Codex CLI 通常用 OpenAI Responses / OpenAI 相容流程。
不要把控制台登入密碼、Cookie 或截圖中的完整金鑰傳給他人。

操作步驟

1. 登入控制台

打開 AIXHUB 控制台並登入。如果還沒有帳戶，先看帳戶註冊與登入。

2. 建立 API Key

進入：

建立一把專用金鑰。建議一個工具使用一把 Key，例如 Claude Code 一把、Codex CLI 一把。這樣後續撤銷、限額和排錯都比較清楚。

3. 複製模型 ID

進入：

找到你要使用的模型，複製完整模型 ID。不要自己縮寫模型名稱，也不要照搬舊截圖或其他網站的模型名稱。

4. 先用最小請求測試服務

把下面兩個值換成你自己的內容：

sk-your-key：你的 AIXHUB API Key。
panel-model-id：控制台「可用渠道」中複製的完整模型 ID。

macOS / Linux：

export AIXHUB_API_KEY="sk-your-key"
export AIXHUB_MODEL="panel-model-id"

Windows PowerShell：

$env:AIXHUB_API_KEY = "sk-your-key"
$env:AIXHUB_MODEL = "panel-model-id"

如果你要驗證 Anthropic 相容協定，使用：

POSThttps://api.aixhub.org/v1/messages

macOS / Linux：

curl https://api.aixhub.org/v1/messages \
  --header "content-type: application/json" \
  --header "x-api-key: $AIXHUB_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data "{\"model\":\"$AIXHUB_MODEL\",\"max_tokens\":64,\"messages\":[{\"role\":\"user\",\"content\":\"Reply with OK only.\"}]}"

Windows PowerShell：

$headers = @{
  "x-api-key" = $env:AIXHUB_API_KEY
  "anthropic-version" = "2023-06-01"
}
$body = @{
  model = $env:AIXHUB_MODEL
  max_tokens = 64
  messages = @(
    @{ role = "user"; content = "Reply with OK only." }
  )
} | ConvertTo-Json -Depth 4

Invoke-RestMethod `
  -Uri "https://api.aixhub.org/v1/messages" `
  -Method Post `
  -Headers $headers `
  -ContentType "application/json" `
  -Body $body

5. 回到用量記錄核對

進入：

確認剛才的請求有出現在記錄裡。這比只看終端機輸出更可靠，因為它能證明請求確實經過 AIXHUB。

驗證結果

你應該同時看到兩個結果：終端機收到正常回應，並且 AIXHUB 用量記錄出現一筆對應請求。

如果終端機成功但用量記錄沒有資料，通常代表你沒有打到 AIXHUB；請重新檢查 Base URL。如果用量記錄有錯誤，請保留狀態碼與錯誤訊息，再看常見問題與錯誤處理。

常見問題

401：API Key 不完整、已撤銷，或環境變數沒有在目前終端機生效。
403：帳戶、方案、餘額、分組或模型路由權限不符合。
404 / model not found：模型 ID 不正確，回到「可用渠道」重新複製。
429：請求太快或並行太高，降低頻率，並按回應中的 Retry-After 等待。
工具仍跳官方登入：你可能把 AIXHUB Key 填到了官方登入流程，而不是自訂 API 供應商設定。

下一步

基本請求跑通後，依你要使用的工具繼續：

快速開始

本頁目錄