---
title: "工具集成"
description: "pirouter 原生支持 OpenAI、Anthropic、Gemini 三种协议，大多数工具只需要改三项设置：base URL、API key 和模型 ID。"
canonical: "https://pirouter.ai/zh/docs/integrations"
last-updated: "2026-10-13"
lang: "zh"
source: "content/docs/zh/integrations/index.mdx"
---

# 工具集成

pirouter 原生支持 OpenAI、Anthropic、Gemini 三种协议，大多数工具只需要改三项设置：base URL、API key 和模型 ID。

## SDK

各家官方 SDK 不需要任何插件。设置对应协议的 base URL，传入你的 pirouter key 即可。

- [OpenAI SDK](https://pirouter.ai/zh/docs/models.md#openai-协议): Base URL `https://api.pirouter.ai/v1`。其余设置不用改。
- [Anthropic SDK](https://pirouter.ai/zh/docs/models.md#anthropic-协议): Base URL `https://api.pirouter.ai`。不带 `/v1`，SDK 会自己拼上。
- [Google GenAI SDK](https://pirouter.ai/zh/docs/models.md#gemini-协议): Base URL `https://api.pirouter.ai`。另加 `Authorization: Bearer` 请求头。

三个 SDK 都有 Python 和 TypeScript 版本，示例可以直接运行。

## 哪些模型支持哪种协议

pirouter 不在协议之间做转换。一个工具只能使用接受它所说协议的模型。

- [浏览全部模型](https://pirouter.ai/zh/models): 每个模型的详情页列出它接受的协议。

用某个模型不接受的协议去请求它，会返回 `422 validation_failed`。

## 把任意 OpenAI 兼容工具指向 pirouter

大多数工具读取两个环境变量。设置一次，之后照常启动工具。

`~/.zshrc`:

```bash
export OPENAI_BASE_URL="https://api.pirouter.ai/v1"
export OPENAI_API_KEY="$PIROUTER_API_KEY"
```

> **规划中，尚未上线：** 各个编程 Agent、编辑器和聊天客户端的分步页面会逐个加到这里，每一页都先用真实 key 安装并跑通之后才发布。

> **提示：** 还没有 key？[快速开始](https://pirouter.ai/zh/docs/quickstart.md)会带你创建一个并发出第一个请求。