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

← 上一页
产品概念
下一页 →
绑定你的订阅