OpenBiliPortal

网络与连接说明

接入方式

请根据客户端协议选择对应的 Base URL：

场景 Base URL 说明
OpenAI Compatible https://api.openbili.com/v1 适用于 OpenAI SDK、Cursor、Cline、Continue、Cherry Studio
Anthropic 原生 https://api.openbili.com 适用于 Claude Code、Anthropic SDK
Gemini 原生 https://api.openbili.com 适用于 Google Gemini SDK、自建网关聚合

推荐使用流式模式

建议所有交互场景启用 stream: true。 流式模式下首字等待时间可降低至 2-3 秒，非流式需要等待模型生成全部内容后才一次性返回，大模型生成较长回复时容易出现超时。

如果你在 Cherry Studio、ChatBox 等客户端中遇到响应超时或空内容，请先确认是否开启了流式（Streaming）模式。

连接排查

  1. 检查 Base URL 是否与客户端协议一致。
  2. 检查出口网络是否允许访问 api.openbili.com。
  3. 检查代理、防火墙或网关是否拦截 HTTPS 长连接 / SSE。
  4. 检查本地 DNS 和证书校验是否正常。
  5. 如果响应超时或长时间无内容：请确认请求中是否包含 "stream": true，非流式请求在模型生成较长内容时可能超时。

OpenAI Compatible 示例（流式）

curl https://api.openbili.com/v1/chat/completions \
  -H "Authorization: Bearer sk-nex-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "你好"}],
    "max_tokens": 256,
    "stream": true
  }'

Anthropic Messages API 示例（流式）

curl https://api.openbili.com/v1/messages \
  -H "x-api-key: sk-nex-your-key-here" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "你好"}],
    "max_tokens": 256,
    "stream": true
  }'

如果客户端只让你填写 Base URL，则 Anthropic 原生客户端请填写 https://api.openbili.com；SDK 会继续按协议请求 /v1/messages。