HopBase 文檔Base URL 與協議
按模型和客戶端選擇 HopBase 的 OpenAI 或 Anthropic 兼容地址。
| 場景 | 協議 | Base URL |
|---|---|---|
| Claude 模型（Claude Code、Anthropic SDK） | 僅 Anthropic Messages——不支援 /v1/chat/completions 與 /v1/responses | https://api.hop-base.com |
| Codex CLI | OpenAI Responses | https://api.hop-base.com/v1 |
| GPT 對話 | OpenAI Chat Completions 或 Responses；也支援 Anthropic Messages，Claude Code 可直連 | https://api.hop-base.com/v1；Anthropic：https://api.hop-base.com |
| Gemini 對話（「Gemini 全系（含生圖）」分組） | OpenAI Chat Completions 或 Responses；也支援 Anthropic Messages，Claude Code 可直連。不支援 Codex CLI | https://api.hop-base.com/v1；Anthropic：https://api.hop-base.com |
| Gemini 對話（「Gemini 官方直連」分組） | OpenAI Chat Completions 或 Responses；也支援 Anthropic Messages，Claude Code 可經 CC Switch 直連（模型名須填 Gemini 型號 ID）。三協議均支援工具調用（詳見） | https://api.hop-base.com/v1；Anthropic：https://api.hop-base.com |
| Grok 對話 | OpenAI Chat Completions 或 Responses；也支援 Anthropic Messages，Claude Code 可直連。不支援 Codex CLI | https://api.hop-base.com/v1；Anthropic：https://api.hop-base.com |
| 通義千問對話 | OpenAI Chat Completions 或 Responses；也支援 Anthropic Messages，Claude Code 可直連 | https://api.hop-base.com/v1；Anthropic：https://api.hop-base.com |
| 豆包 Seed 對話 | OpenAI Chat Completions 或 Responses；也支援 Anthropic Messages | https://api.hop-base.com/v1；Anthropic：https://api.hop-base.com |
| DeepSeek V4 / V4.1 | OpenAI Chat Completions 或 Responses；也支援 Anthropic Messages，Claude Code 可直連 | https://api.hop-base.com/v1；Anthropic：https://api.hop-base.com |
DeepSeek、GLM 美國區（-us） | OpenAI Chat Completions、Responses 與 Anthropic Messages 均可用，Claude Code 可直連，見美國區 | https://api.hop-base.com/v1；Anthropic：https://api.hop-base.com |
| GLM-5.3 / GLM-5.3 Flash（「GLM 官方直連」分組） | 僅 OpenAI Chat Completions——不支援 /v1/responses 與 /v1/messages，呼叫返回 400。Codex CLI 無法接入；Claude Code 需要 CC Switch 本機路由 | https://api.hop-base.com/v1 |
| Kimi K3 | 僅 OpenAI Chat Completions——不支援 /v1/responses 與 /v1/messages，呼叫返回 404。Codex CLI 無法接入；Claude Code 需要 CC Switch 本機路由 | https://api.hop-base.com/v1 |
| GPT Image、Gemini Banana、Seedream | OpenAI Images | https://api.hop-base.com/v1 |
表中沒有列出的協議即不支援。Gemini 也不提供原生 :generateContent 路徑，此端點不接受 x-goog-api-key。
HopBase 同時提供 OpenAI 與 Anthropic 兼容協議，用哪一種由客戶端和模型類型共同決定，不由密鑰格式決定。
常用端點
從 OpenAI、OpenRouter 或 Anthropic 遷移過來，見從其他平台遷移；/v1/models、/v1/usage 與公開目錄的回傳欄位見帳戶與目錄 API。
| 能力 | 端點 |
|---|---|
| 模型發現 | GET /v1/models |
| 查詢目前密鑰餘額與用量 | GET /v1/usage |
| 公開模型目錄與牌價（無需密鑰） | GET /api/v1/models/pricing |
| OpenAI 對話 | POST /v1/chat/completions |
| OpenAI Responses | POST /v1/responses |
| Anthropic Messages | POST /v1/messages |
| 圖片生成 | POST /v1/images/generations |
| 圖片編輯 | POST /v1/images/edits |
| 語音合成 | POST /v1/audio/speech / POST /v1/t2a_v2 |
| 非同步生圖任務查詢 | GET /v1/images/tasks?task_id= |
| 素材上傳（非同步任務的參考圖／影片） | POST /v1/sd/assets |
| 影片生成提交 | POST /v1/video/generate |
| 影片任務輪詢 | GET /v1/video/tasks/{task_id} |
| 可靈人臉辨識 | POST /v1/kling/faces |
| 可靈主體 | POST /v1/kling/subjects / GET /v1/kling/subjects |
| 萬相 / 快樂馬影片提交 | POST /api/v1/services/aigc/video-generation/video-synthesis |
| 萬相 / 快樂馬任務輪詢 | GET /api/v1/tasks/{task_id} |
POST /v1/video/generate 與 GET /v1/video/tasks/{task_id} 是所有非同步影片系列共用的兩個端點——Seedance、MiniMax、可靈、Grok 影片都走這兩條路徑提交與輪詢，差別只在請求內容與模型 ID。可靈只需 HopBase 的 Base URL 與 API Key。
萬相 / 快樂馬沿用原生路徑，前面不帶 /v1：
萬相 3.0 與快樂馬不使用上面的 /v1/video/generate，而是直接沿用官方原生路徑，掛在網域根目錄下：https://api.hop-base.com/api/v1/services/aigc/video-generation/video-synthesis——/api/v1/... 前面沒有額外的 /v1。
Claude 密鑰配成 OpenAI Compatible 時會訪問錯誤的協議路徑，並返回 404「當前平臺不支持該 API 路徑」。此時應把供應商類型改為 Anthropic，並移除 Base URL 末尾的 /v1。
下一步
- OpenAI SDK：OpenAI 協議的 Base URL、金鑰與對話範例
- Anthropic SDK：Anthropic Messages 協議(不帶 /v1)
- 可用模型：查看金鑰可用的模型 ID