快速开始

1. 获取 API Key

建议按环境或业务用途创建独立 Key，便于权限控制、用量追踪和问题排查。

2. 发送第一个请求

AIone 完全兼容 OpenAI Chat Completions API。只需设置 base_url 为 https://api.openbili.com/v1，即可使用 OpenAI SDK 或兼容客户端。

推荐使用流式模式（stream）： 在交互场景中建议始终启用 stream: true，可将首字等待时间从 10 秒以上降低至 2-3 秒，体验显著提升。

Python 示例（流式，推荐）

from openai import OpenAI
 
client = OpenAI(
    api_key="sk-nex-your-key-here",
    base_url="https://api.openbili.com/v1",
)
 
stream = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[
        {"role": "user", "content": "你好，请介绍一下自己"}
    ],
    max_tokens=4096,
    stream=True,
)
 
for chunk in stream:
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="", flush=True)
print()

Python 示例（非流式）

from openai import OpenAI
 
client = OpenAI(
    api_key="sk-nex-your-key-here",
    base_url="https://api.openbili.com/v1",
)
 
response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[
        {"role": "user", "content": "你好，请介绍一下自己"}
    ],
    max_tokens=4096,
)
 
print(response.choices[0].message.content)

Node.js 示例（流式，推荐）

import OpenAI from 'openai';
 
const client = new OpenAI({
  apiKey: 'sk-nex-your-key-here',
  baseURL: 'https://api.openbili.com/v1',
});
 
const stream = await client.chat.completions.create({
  model: 'claude-sonnet-4-6',
  messages: [
    { role: 'user', content: '你好，请介绍一下自己' },
  ],
  max_tokens: 4096,
  stream: true,
});
 
for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content;
  if (content) process.stdout.write(content);
}
console.log();

cURL 示例（流式）

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

3. 切换模型

所有模型均已适配 v1/chat/completions 端点。只需更改 model 参数即可切换：

模型	model 参数	适用场景
Claude Sonnet 4.6	`claude-sonnet-4-6`	日常推荐，速度与质量平衡
Claude Opus 4.8	`claude-opus-4-8`	最强推理，复杂任务
Claude Sonnet 4.5	`claude-sonnet-4-5-20250929`	高质量通用推理与代码
Claude Opus 4.5	`claude-opus-4-5-20251101`	顶级复杂分析
Claude Haiku 4.5	`claude-haiku-4-5-20251001`	极速响应，高并发
Claude Sonnet 4	`claude-sonnet-4-20250514`	稳定版本，兼容性好
GPT-5.5	`gpt-5.5`	OpenAI 当前主推旗舰
GPT-5.2	`gpt-5.2`	高质量通用与编码任务
GPT-5	`gpt-5`	已有接入兼容型号
GPT-5 Mini	`gpt-5-mini`	高并发、低延迟
GPT-4.1	`gpt-4.1`	代码与复杂指令处理
GPT-4o	`gpt-4o`	多模态与通用任务
Gemini 3.1 Pro	`gemini-3.1-pro`	复杂推理与长上下文
Gemini 2.5 Flash	`gemini-2.5-flash`	速度优先场景
Gemini 2.5 Flash Lite	`gemini-2.5-flash-lite`	更低成本的高并发场景

完整模型列表可通过控制台模型与定价页面或 /v1/models 接口查看。

4. 使用沙箱测试

登录控制台后，前往沙箱测试页面，可直接在浏览器中测试各模型效果，无需编写代码。