Docs /
Getting Started /
快速开始
快速开始
PURO AI 提供一个统一的 OpenAI 兼容端点 —— 你已有的 SDK 代码只需要改 base_url 和 api_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,请选择对应格式以获得最完整的字段兼容:
https://ai.puro.im/v1— OpenAI 兼容格式(推荐,覆盖 95% 场景)https://ai.puro.im/anthropic— Anthropic Messages 格式(原生 Claude SDK)https://ai.puro.im/google— Google GenAI 格式(原生 Gemini SDK)
一个
sk-puro-* 可以同时用于三种 base_url —— 鉴权和计费是统一的,你不需要为不同 SDK 维护多个 key。
下一步
把 PURO 接入到你常用的工具:
- 在 Claude Code 中使用 PURO —
ANTHROPIC_BASE_URL环境变量一行搞定 - 在 Cursor 中使用 PURO — 自定义模型 + 自定义 base_url
- 在 Cline / Roo Code 中使用 PURO — 选择 "OpenAI compatible"
- 在 Continue 中使用 PURO — config.yaml 添加 provider