---
title: "简介"
description: "pirouter 是大模型 API 路由平台：一个 API 调用 OpenAI、Anthropic、Google 等厂商的模型，每个请求都路由到最优上游。"
canonical: "https://pirouter.ai/zh/docs"
last-updated: "2026-10-13"
lang: "zh"
source: "content/docs/zh/(start)/index.mdx"
---

# 好模型 配好路由

pirouter 是大模型 API 路由平台：一个 API 调用 OpenAI、Anthropic、Google 等厂商的模型，每个请求都路由到最优上游。一个 key 通用 OpenAI、Anthropic、Gemini 三种协议。

- [快速开始](https://pirouter.ai/zh/docs/quickstart.md)
- [API 参考](https://pirouter.ai/zh/docs/api.md)

cURL:

```bash
curl https://api.pirouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $PIROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-sol",
    "messages": [{ "role": "user", "content": "Hello!" }]
  }'
```

Python:

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.pirouter.ai/v1",
    api_key=os.environ["PIROUTER_API_KEY"],
)

completion = client.chat.completions.create(
    model="openai/gpt-6-sol",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(completion.choices[0].message.content)
```

TypeScript:

```ts
import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://api.pirouter.ai/v1',
  apiKey: process.env.PIROUTER_API_KEY,
})

const completion = await client.chat.completions.create({
  model: 'openai/gpt-6-sol',
  messages: [{ role: 'user', content: 'Hello!' }],
})
console.log(completion.choices[0].message.content)
```

## SDK 的 base URL

- OpenAI: `https://api.pirouter.ai/v1`
- Anthropic: `https://api.pirouter.ai`
- Gemini: `https://api.pirouter.ai`

这三个值是填进各家官方 SDK 的 base URL，key 是同一个。已经在用某家 SDK 的话，只需要换 base URL 和 key，代码其余部分不动。

直接发 HTTP 请求时的完整路径见[三种协议](https://pirouter.ai/zh/docs/models.md#三种协议)。

## 从这里开始

- [发出第一个请求](https://pirouter.ai/zh/docs/quickstart.md): 创建 key，充值，调通一个模型。
- [接入你的工具](https://pirouter.ai/zh/docs/integrations.md): 把官方 SDK 和编程工具指向 pirouter。
- [查阅 API](https://pirouter.ai/zh/docs/api.md): 全部端点，按它使用的协议分组。

## 接入前要知道的

- [鉴权与 API key](https://pirouter.ai/zh/docs/authentication.md): key 放在哪个请求头，怎么创建、到期和吊销。
- [模型与协议](https://pirouter.ai/zh/docs/models.md): 模型 ID 怎么写，每个模型接受哪些协议。
- [定价与计费](https://pirouter.ai/zh/docs/billing.md): 预付钱包怎么扣费，怎么充值，余额不足会怎样。