快速開始

Anthropic 協議地址不帶 /v1，客戶端會自動補全；OpenAI 協議地址必須帶 /v1。

接入步驟

三步接入：註冊帳號，建立金鑰，把 Base URL 和金鑰填進你的工具或程式碼。

發送第一個請求

先用當前密鑰讀取模型列表，確認它能呼叫哪些模型：

curl https://api.hop-base.com/v1/models \
  -H "Authorization: Bearer sk-你的密鑰"

再發一個最小對話請求。curl、Python、Node.js、Go、Java 五個分頁用 OpenAI 協議呼叫 gpt-5.6-sol，需要 Codex 分組的密鑰；「Claude」分頁用 Anthropic 協議呼叫 claude-sonnet-5，需要 Claude 分組的密鑰。換成別的模型種類時，把 model 換成該密鑰在 /v1/models 裡返回的 ID。

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密鑰" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "只回覆 ok"}]
  }'

成功時返回 HTTP 200。OpenAI 協議的回覆在 choices[0].message.content，Anthropic 協議的回覆在 content[0].text，兩者都帶 usage 用量欄位：

{
  "object": "chat.completion",
  "model": "gpt-5.6-sol",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "ok" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 12, "completion_tokens": 2, "total_tokens": 14 }
}

返回 401 表示密鑰不對；返回 404 且提示分組不支援該模型，表示這把密鑰的所有分組都不提供這個模型，請換成 /v1/models 裡的 ID，或給密鑰加上對應分組。

不想手動修改項目時，直接使用交給 AI 接入。

餘額與計費

• 預付費：先在控制台左側選單「增值」為帳戶儲值，呼叫按實際用量從餘額中扣除；餘額用完後新請求返回 402。
• 單價：以登入後的模型廣場為準；每一筆扣費可在控制台「使用記錄」中查看。
• 失敗不收費：失敗的請求原則上不計費，串流中途斷開按已經產出的部分計費。完整規則見並行、逾時與計費。

分組怎麼選

按你要呼叫的模型選分組。一把密鑰可包含1～10 個分組，每個請求按服務該模型的分組計費。建立密鑰時的選單只顯示目前在售的分組，模型有重疊的分組無法同時選上（「GPT 官方直連(Azure)」與 Codex 分組、「GPT Image 全系」混用除外，見下方 GPT 表格後的說明）；訂閱類分組只能單獨成一把密鑰。實際結算價格以登入後的模型廣場為準，下表只說明每個分組能呼叫哪些模型。分組名稱以控制台繁體中文介面顯示的為準。

Claude Code 與 Claude API

對話與編程（OpenAI 協議）

Azure 與 Codex、GPT Image 混用：一把金鑰可以同時選「GPT 官方直連(Azure)」和 Codex Plus 或 Codex Pro 其中一個，也可以再加上「GPT Image 全系」，不需要指定來源。

• 兩組都有的型號優先走 Azure 分組，與勾選順序無關：與 Codex 分組重疊的是 gpt-5.5、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-6-sol、gpt-6-luna、gpt-6-astra、gpt-6.1-sol，與「GPT Image 全系」重疊的是 gpt-image-2.5-flare、gpt-image-2.5-sunburst。Azure 在還沒輸出任何內容前失敗，會自動切到另一個分組。已經開始輸出後中斷不會切換。
• 按實際服務請求的分組計費，使用記錄顯示的也是實際分組。
• 只在一個分組裡的型號照常走該分組，例如 codex-* 只在 Codex 分組，gpt-5.4、gpt-4.1 只在 Azure 分組，gpt-image-2 只在「GPT Image 全系」。
• 走 Azure 分組的請求不支援 Fast（priority）檔，按標準檔處理、按標準價計費。
• 建立金鑰彈窗、金鑰列表和接入彈窗會在這兩個分組上標「優先」「備用」，並附一句計費說明。

Codex Plus 與 Codex Pro 等其他模型重疊的分組，仍不能放進同一把金鑰。

圖片生成

Gemini Banana 生圖在上面的兩個 Gemini 分組裡，Grok 生圖在「Grok 全系」裡，可靈生圖在下面的「可靈官方」裡。

影片生成

語音

下一步

• OpenAI SDK、Anthropic SDK、curl——完整的對話、串流與工具呼叫範例
• 可用模型——各模型的 ID 與能力
• 並行、逾時與計費——並行上限、逾時和計費規則
• 錯誤碼與重試——每個錯誤碼的含義和該不該重試