OpenBiliPortal

认证方式

AIone 同时支持 OpenAI 兼容协议和 Anthropic 原生协议。请根据客户端类型选择对应的认证头和 Base URL。

OpenAI 兼容格式

适用于 OpenAI SDK、Cursor、Cline、Continue 以及自研 OpenAI Compatible 客户端。

  • Base URL: https://api.openbili.com/v1
  • 认证头：
Authorization: Bearer sk-nex-xxxxxxxxxxxxxxxxxxxx

示例：

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-20250514",
    "messages": [{"role": "user", "content": "你好"}],
    "max_tokens": 256
  }'

Anthropic 原生格式

适用于 Claude Code、Anthropic SDK 以及直接调用 Messages API 的客户端。

  • Base URL: https://api.openbili.com
  • 认证头：
x-api-key: sk-nex-xxxxxxxxxxxxxxxxxxxx
anthropic-version: 2023-06-01

示例：

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-20250514",
    "messages": [{"role": "user", "content": "你好"}],
    "max_tokens": 256
  }'

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

Gemini 原生格式

适用于 Google Gemini SDK、自建网关聚合、以及直接调用 Gemini generateContent API 的客户端。

  • Base URL: https://api.openbili.com
  • 认证头：
Authorization: Bearer sk-nex-xxxxxxxxxxxxxxxxxxxx

示例：

curl https://api.openbili.com/v1beta/models/gemini-2.5-flash:generateContent \
  -H "Authorization: Bearer sk-nex-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "你好"}]}],
    "generationConfig": {"maxOutputTokens": 256}
  }'

请求格式与 Google Gemini API 完全一致，详细参数请参考 Gemini 原生接口 文档。

安全提示

  • API Key 以 sk-nex- 前缀开头，可在 AIone 控制台 创建和管理。
  • 请勿将 API Key 提交到代码仓库
  • 请勿在前端代码中硬编码 API Key
  • 建议使用环境变量存储密钥：
export AIONE_API_KEY="sk-nex-your-key-here"
import os
from openai import OpenAI
 
client = OpenAI(
    api_key=os.environ["AIONE_API_KEY"],
    base_url="https://api.openbili.com/v1",
)

Key 管理

操作 说明
创建 控制台 → API Keys → 创建，可限制允许的模型范围
轮换 创建新 Key，完成业务切换后再禁用或删除旧 Key
禁用/启用 临时暂停 Key 的使用权限
删除 永久删除，不可恢复