認證與 Base URL

使用正確網址層級與認證標頭，執行最小 AIXHUB OpenAI 與 Anthropic 請求。

AIXHUB 提供相容的 OpenAI 與 Anthropic 協定介面。每一筆請求只選一種協定，並讓網址、標頭、請求內容與模型路由保持一致。AIXHUB 金鑰不是 OpenAI 或 Anthropic 官方帳號憑證。

協定	Base URL	完整端點	認證
OpenAI Responses	`https://api.aixhub.org/v1`	`https://api.aixhub.org/v1/responses`	`Authorization: Bearer API_KEY`
Anthropic Messages	`https://api.aixhub.org`	`https://api.aixhub.org/v1/messages`	`x-api-key` 加上 `anthropic-version: 2023-06-01`

上表完整端點用於原始 HTTP 呼叫。SDK 或客戶端要求 Base URL 時，請使用同一列的 Base URL，讓程式庫自行附加資源路徑。

前置條件

為這個應用程式建立專用 AIXHUB API 金鑰。
從模型路由為每一種要測試的協定複製完整模型 ID。路由可能只支援 OpenAI Responses、只支援 Anthropic Messages，或同時支援兩者；不可假設同一模型 ID 一定能測試兩種協定。
使用本機終端機或受控後端，不可在公開前端程式碼執行攜帶秘密的請求。
Bash 範例需要 curl；Windows PowerShell 範例使用內建 Invoke-RestMethod。

操作步驟

設定受保護環境變數

請使用原本沒有 AIXHUB_API_KEY 或兩個模型變數的可丟棄 Shell。在 macOS 或 Linux Bash 以提示方式讀取金鑰，避免真實值進入 Shell 歷史：

read -rsp "AIXHUB API key: " AIXHUB_API_KEY && echo
export AIXHUB_API_KEY
export AIXHUB_OPENAI_MODEL="panel-openai-model-id"
export AIXHUB_ANTHROPIC_MODEL="panel-anthropic-model-id"

Windows PowerShell：

$secureKey = Read-Host "AIXHUB API key" -AsSecureString
$env:AIXHUB_API_KEY = [System.Net.NetworkCredential]::new("", $secureKey).Password
$env:AIXHUB_OPENAI_MODEL = "panel-openai-model-id"
$env:AIXHUB_ANTHROPIC_MODEL = "panel-anthropic-model-id"

請把兩個明顯的模型替代值分別換成支援該協定的完整 ID，並只執行實際需要的協定測試。正式環境使用受保護的秘密管理方式，測試結束後清除暫存 Shell 變數。

測試 OpenAI Bearer 認證

Bash：

curl --fail-with-body --silent --show-error \
  https://api.aixhub.org/v1/responses \
  --header "Authorization: Bearer $AIXHUB_API_KEY" \
  --header "content-type: application/json" \
  --data "{\"model\":\"$AIXHUB_OPENAI_MODEL\",\"input\":\"Reply with OK only.\"}"

PowerShell：

$headers = @{ Authorization = "Bearer $env:AIXHUB_API_KEY" }
$body = @{
  model = $env:AIXHUB_OPENAI_MODEL
  input = "Reply with OK only."
} | ConvertTo-Json -Compress

$response = Invoke-RestMethod `
  -Method Post `
  -Uri "https://api.aixhub.org/v1/responses" `
  -Headers $headers `
  -ContentType "application/json" `
  -Body $body
$response.output |
  Where-Object { $_.type -eq "message" } |
  ForEach-Object { $_.content } |
  Where-Object { $_.type -eq "output_text" } |
  Select-Object -ExpandProperty text

測試 Anthropic 金鑰認證

Bash：

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

PowerShell：

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

$response = Invoke-RestMethod `
  -Method Post `
  -Uri "https://api.aixhub.org/v1/messages" `
  -Headers $headers `
  -ContentType "application/json" `
  -Body $body
$response.content |
  Where-Object { $_.type -eq "text" } |
  Select-Object -ExpandProperty text

同一筆請求不可同時傳送兩套認證。也不要把完整端點貼入會自行附加 /responses 或 /v1/messages 的 SDK 欄位。

清除暫存變數

可丟棄 Bash Shell 測試結束後：

unset AIXHUB_API_KEY AIXHUB_OPENAI_MODEL AIXHUB_ANTHROPIC_MODEL

可丟棄 PowerShell 工作階段測試結束後：

Remove-Item Env:AIXHUB_API_KEY, Env:AIXHUB_OPENAI_MODEL, Env:AIXHUB_ANTHROPIC_MODEL -ErrorAction SilentlyContinue
Remove-Variable headers, body, response, secureKey -ErrorAction SilentlyContinue

若這些變數在本指南之前已屬於其他工作流程，不可刪除或覆寫。請另開測試終端機，或從獲准的秘密來源還原原始值。

驗證

每一筆最小請求都應包含相當於以下內容的模型文字：

OK

PowerShell 範例會擷取 OK；Bash 命令則回傳包含相同文字的完整 JSON。開啟 AIXHUB 用量，分別核對請求時間、所選模型、成功狀態，以及介面有顯示時的協定。本機有回應但沒有相符用量記錄，可能代表請求經過其他 Proxy、Mock 或供應端。

實際執行的每種協定測試都使用相容模型與自己的認證標頭、回傳 OK，並建立相符的 AIXHUB 用量記錄。

常見問題

401： 確認同一個 Shell 內的環境變數有值。OpenAI 需要 Authorization: Bearer 並保留一個空格；Anthropic 需要 x-api-key。
403： 檢查金鑰狀態、金鑰分組、訂閱與餘額。INSUFFICIENT_BALANCE 是 403，不是 429 速率限制。
404 或 /v1/v1： Base URL 與資源路徑使用了錯誤層級。回到表格，依欄位要求選擇 Base URL 或完整端點。
400 或模型錯誤： 重新複製模型 ID，並確認路由支援所選協定。模型問題不一定是 404。
429： 遵守 Retry-After、降低並行數，並只做有限次數重試。不可輪換金鑰規避限制。
瀏覽器 CORS 錯誤： 把 API 金鑰留在受控後端。降低瀏覽器安全性無法讓公開使用秘密金鑰變安全。

回應封裝與重試判斷請繼續閱讀錯誤代碼。

下一步

接著使用 OpenAI Responses、Anthropic Messages、OpenAI Python SDK或 Anthropic Python SDK。

官方資料

最後核對：2026-07-14

認證與 Base URL

本頁目錄