設定教學

三步完成 API 接入

把用戶端設定和常用入口集中到一個頁面。大多數用戶端直接填寫推薦 Base URL；只有用戶端明確要求完整端點或 Messages 協議時，才使用對應網址。

先購買 API Key查看完整開發文件

第一次接入，請按這個順序完成

先選模型並確認價格，再取得 API Key、複製對應 URL、設定一個用戶端，最後送出一筆小請求驗證鏈路。

  1. 01選擇模型並確認價格

    設定用戶端前，先核對模型名稱、上下文長度、圖片支援和計費倍率。

  2. 02準備 API Key

    新用戶：先購買並取得 API Key

  3. 03複製正確的 URL

    大多數 OpenAI-compatible 用戶端使用此網址

  4. 04填寫用戶端設定

    請求成功就代表 Base URL、API Key、模型路由和網路鏈路同時正常。

01

準備 API Key

使用購買成功後收到的 API Key，或仍有額度的既有 Key，並把它保存在伺服器端環境變數中。

  • 新用戶：先購買並取得 API Key
  • 舊用戶：繼續為同一 Key 儲值
  • 設定完成：查詢額度和呼叫記錄
02

複製正確的 URL

OpenAI-compatible 用戶端通常填寫以 /v1 結尾的 Base URL。只有用戶端明確要求完整介面網址時，才填寫具體端點。

推薦 Base URL大多數 OpenAI-compatible 用戶端使用此網址
https://new.weeanno.shop/v1
備用 Base URL用戶端會自動串接 /v1 時使用
https://new.weeanno.shop
Chat Completions 完整端點Chat Completions-compatible 請求完整網址
https://new.weeanno.shop/v1/chat/completions
Responses 完整端點Responses-compatible 請求完整網址
https://new.weeanno.shop/v1/responses
Messages 完整端點Messages-compatible 用戶端完整網址
https://new.weeanno.shop/v1/messages
03

填寫用戶端設定

在用戶端對應欄位中填寫 Base URL 和 API Key。下面範例只含佔位符，不含真實金鑰。

OpenAI-compatible 用戶端

config
base_url = "https://new.weeanno.shop/v1"
api_key = "sk-your-api-key"

Claude Code · Messages 相容

config
export ANTHROPIC_BASE_URL="https://new.weeanno.shop"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

用 cURL 驗證

請求成功就代表 Base URL、API Key、模型路由和網路鏈路同時正常。

bash
curl https://new.weeanno.shop/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

不要把真實 API Key 放進截圖、聊天訊息、瀏覽器前端程式碼或公開儲存庫。

依使用工具選擇設定

先確認工具需要的協定。OpenAI-compatible 工具使用 /v1 Base URL；Claude Code 使用 Messages-compatible 閘道網址。

Cherry Studio · Chatbox · WorkBuddy

OpenAI-compatible 用戶端

填寫這個 Base URL

https://new.weeanno.shop/v1
開啟設定指南

Codex CLI · Cursor · VS Code · Trae · OpenCode

OpenAI-compatible 用戶端

填寫這個 Base URL

https://new.weeanno.shop/v1
開啟設定指南

Claude Code

Claude Code · Messages 相容

填寫這個 Base URL

https://new.weeanno.shop
開啟設定指南

OpenClaw · Hermes · Dify · n8n · LangChain · OpenWebUI

OpenAI-compatible 用戶端

填寫這個 Base URL

https://new.weeanno.shop/v1
開啟設定指南

常見錯誤速查

先依 HTTP 狀態碼定位問題，再決定是否更換模型或 API Key。

401 / 403
OpenAI 相容用戶端使用 Authorization: Bearer <key>；Claude Code 使用 ANTHROPIC_AUTH_TOKEN。
404
確認用戶端需要的是 Base URL 還是完整端點，並核對模型名稱。
429
降低並行請求、縮短上下文，並到 Token 額度頁面檢查剩餘額度。
TIMEOUT
先送出一筆小請求，再檢查網路鏈路，並依退避策略重試。

聯絡武元客服前

請提供足夠的排查資訊，但不要暴露完整 API Key。

  • 工具名稱和版本
  • 模型名稱和 Base URL（API Key 請遮蔽）
  • HTTP 狀態碼、錯誤原文和 request ID
  • 大致發生時間和時區
聯絡武元客服

常用網站入口

購買、儲值、訂單狀態、Token 額度查詢和完整開發文件，都可以從下面的公開網址進入。

網站入口武元官網首頁與導覽
https://weeanno.shop/zh-Hant
購買入口購買並自動取得新的 API Key
https://weeanno.shop/zh-Hant/buy
儲值入口為既有 API Key 增加額度
https://weeanno.shop/zh-Hant/topup
訂單查詢查詢付款和額度入帳狀態
https://weeanno.shop/zh-Hant/topup/query
Token 額度查詢查詢剩餘額度和呼叫記錄
https://weeanno.shop/zh-Hant/quota
開發文件SDK、串流輸出、錯誤碼和限流說明
https://weeanno.shop/zh-Hant/docs