---
title: "快速开始"
description: "五步通过 pirouter 发出第一个请求：从创建 key 到在控制台找到这次请求。已经在用 OpenAI、Anthropic 或 Google 的 SDK 时，只需要换 base URL 和 key。"
canonical: "https://pirouter.ai/zh/docs/quickstart"
last-updated: "2026-10-13"
lang: "zh"
source: "content/docs/zh/(start)/quickstart.mdx"
---

# 快速开始

五步通过 pirouter 发出第一个请求：从创建 key 到在控制台找到这次请求。已经在用 OpenAI、Anthropic 或 Google 的 SDK 时，只需要换 base URL 和 key。

走完下面五步，你会拿到一个 pirouter 的 API key，给钱包充值，发出一个请求，看到流式输出，并在控制台里找到这次请求。

1. **创建 API key**

   用 GitHub、Google 或邮箱验证码登录控制台。第一次登录就完成注册，不需要设置密码。

   - [打开控制台](https://app.pirouter.ai): app.pirouter.ai

   打开 **API Keys**，点 **创建密钥**，填一个名称后确认。

   你应该看到一个以 `sk-pi-` 开头的 key。它只显示这一次，关闭弹窗后无法再查看。现在就把它存进环境变量：

   ```bash
   export PIROUTER_API_KEY="sk-pi-..."
   ```

   只有工作区所有者能创建 key。注册时会自动建一个个人工作区，你就是它的所有者，所以用自己的账号可以直接创建。

2. **给钱包充值**

   注册不附带额度。钱包余额为 0 时，请求返回 `402`，所以发请求之前先充值。

   打开控制台的 **Token 钱包**，点 **充值**。只有工作区所有者能充值。

   选一个金额和支付方式，然后付款。单笔最低 $10，可以用银行卡、支付宝或微信支付。

   你应该看到页面回到控制台，提示金额已到账，**Token 钱包** 里的余额相应增加。

   币种、汇率和收据见[定价与计费](https://pirouter.ai/zh/docs/billing.md#充值)。

3. **发送请求**

   模型 ID 的写法是 `vendor/model`，可用的模型见[模型与协议](https://pirouter.ai/zh/docs/models.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)
   ```

   Python 和 TypeScript 的写法用的是 OpenAI 官方 SDK，先用 `pip install openai` 或 `npm install openai` 安装。

   你应该看到状态码 `200` 和一段 JSON，模型的回复在 `choices[0].message.content` 里。

   返回 `401` 说明 key 没带上或不可用，见[鉴权与 API key](https://pirouter.ai/zh/docs/authentication.md#鉴权失败时的返回)。返回 `402` 说明余额不足。全部错误码和处理办法见[错误码](https://pirouter.ai/zh/docs/errors.md)。

4. **流式输出**

   在请求体里加上 `"stream": true`，并给 curl 加 `-N` 关掉输出缓冲。

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

   你应该看到一行行以 `data: ` 开头的 SSE 事件陆续到达，最后一行是 `data: [DONE]`。

   用 SDK 时把 `stream` 参数设为真，然后遍历返回的事件。

5. **在日志中查看**

   打开控制台的 **日志**。

   你应该看到刚才的请求出现在列表里，带着输入和输出 token 数、费用和延迟。请求发出后几秒才会出现。

   每个响应都带 `X-Pi-Trace-Id` 响应头。给 curl 加 `-i` 可以看到它，把它的值填进日志页的 **按 trace ID 搜索**，就能直接找到这一次请求。

> **提示：** 用的是 Anthropic 或 Google 的 SDK？每种协议有自己的 base URL 和请求格式，示例见[模型与协议](https://pirouter.ai/zh/docs/models.md#每种协议怎么调)。

> **注意：** key 只显示一次。一旦泄露，在控制台吊销它并创建新的，吊销立即生效。

## 下一步

- [鉴权与 API key](https://pirouter.ai/zh/docs/authentication.md): key 放在哪个请求头，怎么到期和吊销。
- [模型与协议](https://pirouter.ai/zh/docs/models.md): 每个模型接受哪些协议，三种协议各怎么调。
- [定价与计费](https://pirouter.ai/zh/docs/billing.md): 钱包怎么扣费，怎么充值。
- [接入工具](https://pirouter.ai/zh/docs/integrations.md): 把 SDK 或编程工具指向 pirouter。