跳到正文
HopBase 文档
登录控制台

curl

使用 HTTP 和 curl 调用 HopBase 的兼容接口。

模型类型协议与端点鉴权
GPT / Gemini / GLMPOST https://api.hop-base.com/v1/chat/completionsAuthorization: Bearer
ClaudePOST https://api.hop-base.com/v1/messagesx-api-key
图片POST https://api.hop-base.com/v1/images/generationsAuthorization: Bearer

鉴权与通用限制

项目规则不符合时
密钥请求头Authorization: Bearer sk-… 或 x-api-key: sk-…，所有端点都接受；不支持 x-goog-api-key 与 URL 参数 ?key=401 missing_api_key / invalid_api_key
端点与分组每个请求都要用该模型协议的端点（例如 Claude 模型只能通过 /v1/messages 调用）404「当前平台不支持该 API 路径」
模型必须是当前密钥所含分组内的模型404 model_not_found
请求体大小整个请求体 ≤ 60 MB413
GET /v1/models返回当前密钥可用的模型 ID；不计费—

请使用当前分组密钥在 GET /v1/models 中实际返回的模型 ID。密钥只能调用它所含分组的模型。

Claude 请显式设置 max_tokens：

Claude 请求不传 max_tokens 不会报错，会被补为 4096：长输出在 4096 处截断（stop_reason: "max_tokens"），请显式设置。

OpenAI 协议（GPT 模型）

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": "你好"}]
  }'

Anthropic 协议（Claude 模型）

curl https://api.hop-base.com/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

流式输出（加 "stream": true）

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

下一步

本页目录

鉴权与通用限制OpenAI 协议（GPT 模型）Anthropic 协议（Claude 模型）流式输出（加 "stream": true）下一步