文档

OneToken 完全兼容 OpenAI API 格式，使用你熟悉的 SDK 即可接入。

快速开始

API 参考

SDK

快速开始

1. 获取 API Key

登录账户后，在 API Keys 页面创建密钥。新用户自动获得免费试用额度。

2. 安装 SDK

Python
pip install openai
Node.js
npm install openai

3. 发起请求

只需将 base_url 指向 https://api.onetoken.love/v1，其余代码与 OpenAI 官方 SDK 完全一致。

from openai import OpenAI

client = OpenAI(
    api_key="sk-onetoken-your-key",
    base_url="https://api.onetoken.love/v1"
)

# Chat Completions
response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手。"},
        {"role": "user", "content": "你好！"}
    ]
)

print(response.choices[0].message.content)

4. 使用 Claude 模型

通过同一个 API，使用 Anthropic Claude 模型：

# 只需更换 model 参数即可
response = client.chat.completions.create(
    model="claude-sonnet-4-8",
    messages=[
        {"role": "user", "content": "解释量子计算的基本原理。"}
    ]
)

print(response.choices[0].message.content)

调用不同模型

所有模型共用同一个 base_url 与 API Key，只需修改请求里的 model 参数即可在不同模型之间自由切换，业务代码无需任何改动。

OpenAI

  • gpt-5.51M 上下文
  • gpt-5.41.05M 上下文
  • gpt-4o-mini128K 上下文
  • o4-mini200K 上下文

Anthropic

  • claude-opus-4-6200K 上下文
  • claude-opus-4-8200K 上下文
  • claude-sonnet-4-8200K 上下文

完整模型列表、能力与价格见 模型与价格 页面。

# 切换模型只需改 model 一个参数
for model in ["gpt-5.5", "claude-opus-4-8", "claude-sonnet-4-8"]:
    resp = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": "用一句话介绍你自己。"}],
    )
    print(model, "->", resp.choices[0].message.content)

图像生成

通过 OpenAI 兼容的图像接口生成图片，模型用 gpt-image-2。

# 图像生成 (images)
img = client.images.generate(
    model="gpt-image-2",
    prompt="一只戴帽子的柴犬，水彩风格",
    size="1024x1024",
)
print(img.data[0].url)

SDK 接入

OneToken 兼容 OpenAI 官方 SDK，只需把 base_url 指向 OneToken 并换上你的 API Key。

Python
pip install openai

from openai import OpenAI
client = OpenAI(api_key="sk-onetoken-your-key", base_url="https://api.onetoken.love/v1")
Node.js
npm install openai

import OpenAI from "openai";
const client = new OpenAI({ apiKey: "sk-onetoken-your-key", baseURL: "https://api.onetoken.love/v1" });
Go (go-openai)
// go get github.com/sashabaranov/go-openai
cfg := openai.DefaultConfig("sk-onetoken-your-key")
cfg.BaseURL = "https://api.onetoken.love/v1"
client := openai.NewClientWithConfig(cfg)
文档 | OneToken