Docs / Getting Started / 快速开始

快速开始

PURO AI 提供一个统一的 OpenAI 兼容端点 —— 你已有的 SDK 代码只需要改 base_urlapi_key 两行,就能用上你绑定的 Claude / ChatGPT / Gemini 订阅。整个过程通常不超过 5 分钟。

STEP 01

绑定订阅

授权你的 Claude / ChatGPT 账号加入池。

STEP 02

创建 API Key

为每个客户端生成独立的 sk-puro-* key。

STEP 03

切换 base_url

改两行代码,剩下和官方 SDK 一模一样。

① 绑定你的订阅

进入 Dashboard → 订阅账号 → 绑定新订阅,选择平台后通过 OAuth 一键授权。每个订阅都会被加入对应的"池",同一池内的请求会自动做负载均衡、限流回退和故障转移。

凭证通过 AES-256 加密存储在隔离的 KMS 中。我们只会用它代理你发出的请求 —— 不会进入训练数据、不会做二次分发。详见 数据隐私

② 创建 API Key

Dashboard → API Keys → 创建 Key 生成一个 sk-puro-* 的 key。建议每个客户端 / 环境单独一个 key,泄漏时可以直接吊销而不影响其他场景。

③ 发送第一个请求

PURO AI 同时兼容 OpenAI 和 Anthropic 的 API 格式。按你原来在用的 SDK 风格选择对应的代码示例即可:

⧉ 复制
# pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="https://ai.puro.im/v1",
    api_key="sk-puro-YOUR_KEY",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-5",       # 可直接写任意平台的模型名
    messages=[
        {"role": "user", "content": "hi, who am I talking to?"}
    ],
)

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

返回结构完全符合 OpenAI 格式,可以无缝对接任何基于 OpenAI SDK 的应用(Cursor / Continue / Cline / Roo Code / Open WebUI …)。

可用模型

绑定后,下列模型都可以直接用 model 字段调用 —— PURO 会根据模型自动路由到对应的订阅池。

MODEL PROVIDER 上下文 状态
claude-sonnet-4-5 Claude Pro / Max 200k OK
claude-opus-4 Claude Max 200k OK
claude-haiku-4-5 Claude Pro / Max 200k OK
gpt-5 ChatGPT Plus / Pro 128k OK
gpt-5-codex ChatGPT Plus / Pro 128k OK
gemini-2.5-pro Gemini Advanced 1M BETA
gemini-2.5-flash Gemini Advanced 1M OK

支持的 base_url

每种格式都提供独立的 base_url —— 如果你在用原生 Anthropic / Google SDK,请选择对应格式以获得最完整的字段兼容:

一个 sk-puro-* 可以同时用于三种 base_url —— 鉴权和计费是统一的,你不需要为不同 SDK 维护多个 key。

下一步

把 PURO 接入到你常用的工具: