AIXHUB 接入文件客戶端、API 與 SDK

從建立 API Key、選擇模型，到設定 Codex 桌面端、Claude Code 或完成第一個可驗證的 API 請求。

設定內容

# config.toml
model_provider = "AIXHUB"
model = "panel-model-id"

[model_providers.AIXHUB]
name = "AIXHUB"
base_url = "https://api.aixhub.org/v1"
wire_api = "responses"
requires_openai_auth = true

# auth.json
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-your-key"
}

驗證說明

Codex 桌面端將透過 Responses 協定連線，金鑰與供應端設定分開保存。

設定內容

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aixhub.org",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key",
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_MODEL": "panel-model-id"
  }
}

驗證說明

Claude Code 將使用 Anthropic 相容協定，Base URL 保持為不含 /v1 的根地址。

設定內容

# config.toml
model_provider = "AIXHUB"
model = "panel-model-id"

[model_providers.AIXHUB]
name = "AIXHUB"
base_url = "https://api.aixhub.org/v1"
wire_api = "responses"
requires_openai_auth = true

# auth.json
{
  "OPENAI_API_KEY": "sk-your-key"
}

驗證說明

Codex CLI 將從獨立的 auth.json 讀取金鑰，並使用 Responses 供應端。

設定內容

curl https://api.aixhub.org/v1/responses \
  -H "Authorization: Bearer $AIXHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "panel-model-id",
    "input": "Reply with AIXHUB connected."
  }'

驗證說明

請求使用測試模型佔位值；發送前請替換為控制台目前可用的模型 ID。

按照你的下一個任務繼續

從註冊到工具設定，每篇文件都圍繞一個可以完成的結果編寫。

開始使用

選擇 SDK 或原生 API，完成第一筆可驗證請求。

常用客戶端

依照實際使用的命令列或桌面工具完成接入。

API 與模型

根據工具使用的協定選擇地址和模型。

控制台功能

查看餘額、方案、金鑰、用量和可用渠道。

驗證與排錯

先用最小請求驗證，再按狀態碼處理問題。