快速开始

本页带你在 5 分钟内完成第一次调用。

1. 获取 API Key

登录控制台 → API Keys → 新建。Key 形如 sk-og-xxxxxxxx，请妥善保存，关闭弹窗后不再展示。

2. 配置环境变量

bash

export ONEGATE_API_KEY="sk-og-xxxxxxxxxxxxxxxx"

3. 发起调用

用你熟悉的 SDK，只改 base_url：

python

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ONEGATE_API_KEY"],
    base_url="https://onegate.club/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "用一句话介绍量子纠缠。"},
    ],
)
print(resp.choices[0].message.content)

node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.ONEGATE_API_KEY,
  baseURL: "https://onegate.club/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.1",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

curl

curl https://onegate.club/v1/chat/completions \
  -H "Authorization: Bearer $ONEGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

4. 切换模型

只改 model 字段即可切换。常用模型：

gpt-5.1 · 通用对话与函数调用
claude-sonnet-4-6 · 代码 / 复杂推理性价比首选
claude-opus-4-7 · 最强能力，价格较高
gemini-2.5-pro · 100 万上下文窗口
doubao-seed-2-0-pro-260215 · 国产模型，中文优势

完整模型与价格见 /models 页面或本文档的「模型列表」。

5. 监控用量

在控制台「总览」可看到余额、本月消费、用量曲线、最近调用日志。每个 API Key 单独计量。