[ PROMPT_NODE_27002 ]
openrouter_setup
[ SKILL_DOCUMENTATION ]
# OpenRouter 设置指南
使用 OpenRouter 访问 Perplexity 模型的完整设置与使用指南。
## 什么是 OpenRouter?
OpenRouter 是一个统一的 API 网关,通过单一 API 接口提供对来自不同提供商的 100 多种 AI 模型的访问。它提供:
- **单一 API 密钥**:用一个密钥访问多个模型
- **统一格式**:兼容 OpenAI 的 API 格式
- **成本追踪**:内置使用监控和计费
- **模型路由**:智能回退和负载均衡
- **按需付费**:无订阅,仅为使用量付费
对于 Perplexity 模型,OpenRouter 提供了对 Sonar Pro Search 等特定模型的独家访问权限。
## 入门指南
### 第 1 步:创建 OpenRouter 账户
1. 访问 https://openrouter.ai/
2. 点击右上角的“Sign Up”
3. 使用 Google、GitHub 或电子邮件注册
4. 如果使用电子邮件注册,请验证您的邮箱
### 第 2 步:添加支付方式
OpenRouter 使用按需付费模式:
1. 导航至 https://openrouter.ai/account
2. 点击“Credits”选项卡
3. 添加支付方式(信用卡)
4. 添加初始额度(建议至少 5 美元)
5. 可选:设置自动充值
**定价说明:**
- 不同模型的每 token 成本不同
- 查看 https://openrouter.ai/perplexity 获取 Perplexity 定价
- 在 https://openrouter.ai/activity 监控使用情况
### 第 3 步:生成 API 密钥
1. 前往 https://openrouter.ai/keys
2. 点击“Create Key”
3. 为您的密钥起一个描述性名称(例如“perplexity-search-skill”)
4. 可选:设置使用限额以确保安全
5. 复制密钥(以 `sk-or-v1-...` 开头)
6. **重要**:安全保存此密钥 - 您无法再次查看它!
**安全提示:**
- 永远不要公开分享您的 API 密钥
- 不要将密钥提交到版本控制系统
- 为不同项目使用单独的密钥
- 设置使用限额以防止意外扣费
- 定期轮换密钥
### 第 4 步:配置环境
您有两种配置 API 密钥的方法:
#### 方案 A:环境变量(推荐)
**Linux/macOS:**
bash
export OPENROUTER_API_KEY='sk-or-v1-your-key-here'
要使其永久生效,请添加到您的 shell 配置文件中:
bash
# 对于 bash:添加到 ~/.bashrc 或 ~/.bash_profile
echo 'export OPENROUTER_API_KEY="sk-or-v1-your-key-here"' >> ~/.bashrc
source ~/.bashrc
# 对于 zsh:添加到 ~/.zshrc
echo 'export OPENROUTER_API_KEY="sk-or-v1-your-key-here"' >> ~/.zshrc
source ~/.zshrc
**Windows (PowerShell):**
powershell
$env:OPENROUTER_API_KEY = "sk-or-v1-your-key-here"
要使其永久生效