# OpenRouter API 配置模板

> 更新时间：2026-09-08
> 把 `YOUR_OPENROUTER_API_KEY` 替换成你在 https://openrouter.ai/keys 生成的真实 Key。

## 公共参数

- Base URL：`https://openrouter.ai/api/v1`
- 鉴权头：`Authorization: Bearer YOUR_OPENROUTER_API_KEY`
- 示例 Model ID：`google/gemma-4-31b-it:free`

## cURL 示例

```bash
curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemma-4-31b-it:free",
    "messages": [{"role": "user", "content": "你好"}]
  }'
```

## OpenAI SDK（Node.js）示例

```js
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: "YOUR_OPENROUTER_API_KEY",
});

const res = await client.chat.completions.create({
  model: "google/gemma-4-31b-it:free",
  messages: [{ role: "user", content: "你好" }],
});
console.log(res.choices[0].message.content);
```

## Python SDK 示例

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="YOUR_OPENROUTER_API_KEY",
)

res = client.chat.completions.create(
    model="google/gemma-4-31b-it:free",
    messages=[{"role": "user", "content": "你好"}],
)
print(res.choices[0].message.content)
```

## 常见错误

1. **401 Unauthorized**：Key 无效或未填。检查 `Authorization: Bearer YOUR_OPENROUTER_API_KEY`。
2. **404 model not found**：Model ID 写错或模型已下架。回 Models 页复制完整 ID（含 `:free`）。
3. **429 Too Many Requests**：免费档速率限制。降低频率、轮换免费模型，或购买 ≥10 信用额度提升限额。详见 https://tool-archive.pages.dev/guides/openrouter-429-fix。

## 官方资料

- 官方 Models 页：https://openrouter.ai/models
- 官方 FAQ：https://openrouter.ai/docs/faq
- 429 排错教程：https://tool-archive.pages.dev/guides/openrouter-429-fix