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