> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenRouter 用不了：报 403「Access denied by security policy」怎么办

> OpenRouter 返回 403「Access denied by security policy」，网站显示「Sorry, you have been blocked」：为什么被拒看的是 IP 地址、跟密钥无关，以及怎么不用 VPN 把代码、Claude Code 和 Cline 迁到 RuAPI——接口地址、密钥和一张模型名对照表。

**先说结论**：OpenRouter 用不了、报 403 和 `Access denied by security policy`，说明请求被 OpenRouter 入口处的防护拦下了，到不了模型，也轮不到检查密钥。OpenRouter 目前就是这样回应来自俄罗斯 IP 地址的请求（我们 2026-11-21 的检测）。防护看的是 IP 地址，所以换新密钥、换个账号都没用。想不开 VPN 继续用，就把代码迁到 RuAPI：请求格式一样，都是 OpenAI 兼容格式。要改的只有三样：接口地址（`base_url`）、密钥和模型名（对照表见下）。

## 报错长什么样

调用 API（`/api/v1/chat/completions`、`/api/v1/models` 等）收到状态码 **403**：

```json theme={null}
{ "success": false, "error": "Access denied by security policy." }
```

在 OpenAI 的 Python SDK 里，报错是这样的：`openai.PermissionDeniedError: Error code: 403 - {'success': False, 'error': 'Access denied by security policy.'}`。

openrouter.ai 网站也打不开，看到的是 Cloudflare 的拦截页「Sorry, you have been blocked」，下面一行写着「You are unable to access openrouter.ai」。

> [!NOTE]
>
> 2026-11-21 用 [globalping.io](https://globalping.io) 检测：莫斯科和圣彼得堡几家主机商的节点请求 `/api/v1/models` 和 `/api/v1/chat/completions`（不带密钥），都收到这个响应；德国节点同样请求 `/api/v1/models`，拿到的是模型列表。MTS、Rostelecom、Beeline、MGTS 四家的家庭宽带节点请求 `/api/v1/models` 也收到同样的响应，打开网站看到的也是同一个 Cloudflare 拦截页。

## OpenRouter 为什么返回 403

* **这是按 IP 地址拦截，不是密钥出错**。按 [OpenRouter 的文档](https://openrouter.ai/docs/api-reference/errors)（2026-11-21 核对），它平常的报错是另一种格式：`{"error": {"code": …, "message": …}}`。这次的响应来自网站前面的 Cloudflare 防护，也就是在浏览器里显示「Sorry, you have been blocked」的那一层。请求到不了 OpenRouter 的 API，也轮不到检查密钥。
* **先停付款，后停访问**。2026 年 5 月 11 日，账号地区为「俄罗斯」的用户收到 OpenRouter 的邮件：不再支持与其所在地区相关的使用和付款。此后用卡、经 Coinbase 用加密货币都充不进去（[Habr 2026-05-12 的文章](https://habr.com/ru/articles/1034012/)）。现在服务本身也打不开了，见上面的检测。我们没有找到 OpenRouter 的正式公告。文章里常说的充值办法和各自的风险，见[从俄罗斯怎么给 OpenRouter 充值](https://docs.ruapi.ai/zh/pay-openrouter-russia.md)。
* **用 VPN 违反条款**。[OpenRouter 服务条款](https://openrouter.ai/terms)（2026-08-31 版）第 5.7 条禁止用 VPN 或代理访问模型厂商不允许在某些国家使用的模型，也禁止绕过 OpenRouter 为此设的限制。违反算重大违约，可能被立即暂停或终止使用。按第 9 条，违反条款时没用完的额度不退。

## OpenRouter 用不了怎么办

| OpenRouter 原来接在哪里 | 要改什么 |
| - | - |
| 自己用 OpenAI SDK、LangChain 等写的代码 | 接口地址、密钥和模型名，[步骤见下](#把代码从-openrouter-迁到-ruapi) |
| Claude Code | 两个变量和模型名，见 [Claude Code 一节](#claude-code-从-openrouter-换过来) |
| Cline、Kilo Code、Continue 等自带「OpenRouter」选项的工具 | 把「OpenRouter」提供商换成 RuAPI（做法见[常见问题](#常见问题)） |

## 把代码从 OpenRouter 迁到 RuAPI

**1. 账号**

在 [www.ruapi.ai](https://www.ruapi.ai/?lng=zh-CN\&utm_source=docs\&utm_campaign=zh-openrouter-403-access-denied) 注册，邮箱、Google 或 Yandex 都行。

**2. 余额**

控制台 →「**钱包管理**」：USDT 或 USDC（TRC20 / BEP20 / Polygon；USDT 还可以走 TON），5 USDT 起，不需要外国卡。还没有 USDT 的话，[用 SBP 拿卢布买](https://docs.ruapi.ai/zh/buy-usdt.md)。也可以用外国银行的卡（Visa / Mastercard）付。

**3. 密钥**

控制台 →「**令牌管理**」→「**添加令牌**」。RuAPI 的密钥以 `sk-` 开头，用它替换 OpenRouter 的密钥（`sk-or-…`）。

**4. 代码**

改 `base_url`、密钥和模型名。对话、流式输出、函数调用、传图片都和原来一样。

```python Python theme={null}
from openai import OpenAI

# 原来：OpenAI(api_key="sk-or-...", base_url="https://openrouter.ai/api/v1")
client = OpenAI(
    api_key="sk-你的RuAPI密钥",
    base_url="https://www.ruapi.ai/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5-5",  # 原来："anthropic/claude-sonnet-5.5"
    messages=[{"role": "user", "content": "你好！"}],
)
print(resp.choices[0].message.content)
```

```javascript Node.js theme={null}
import OpenAI from "openai";

// 原来：baseURL: "https://openrouter.ai/api/v1"
const client = new OpenAI({
  apiKey: "sk-你的RuAPI密钥",
  baseURL: "https://www.ruapi.ai/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5-5", // 原来："anthropic/claude-sonnet-5.5"
  messages: [{ role: "user", content: "你好！" }],
});
console.log(resp.choices[0].message.content);
```

```bash curl theme={null}
curl https://www.ruapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的RuAPI密钥" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-5-5", "messages": [{"role": "user", "content": "你好！"}]}'
```

## 模型名：OpenRouter → RuAPI

规律：去掉「/」前面的厂商前缀（`anthropic/`、`openai/`、`google/` 等）。Claude 模型版本号里的点换成连字符：`5.5` → `5-5`。例外是 `deepseek-flash` 和 `MiniMax-M3.1-Flash`（区分大小写），见下表。

| OpenRouter | RuAPI |
| - | - |
| `anthropic/claude-opus-5.5` | `claude-opus-5-5` |
| `anthropic/claude-sonnet-5.5` | `claude-sonnet-5-5` |
| `anthropic/claude-haiku-5.5` | `claude-haiku-5-5` |
| `anthropic/claude-fable-5.2` | `claude-fable-5-2` |
| `openai/gpt-6.2-sol` | `gpt-6.2-sol` |
| `openai/gpt-6.2-astra` | `gpt-6.2-astra` |
| `openai/gpt-6.1-sol` | `gpt-6.1-sol` |
| `openai/gpt-6-luna` | `gpt-6-luna` |
| `openai/gpt-5.4-mini` | `gpt-5.4-mini` |
| `google/gemini-4-argon` | `gemini-4-argon` |
| `google/gemini-3.8-flash` | `gemini-3.8-flash` |
| `deepseek/deepseek-v4.1-flash` | `deepseek-flash` |
| `deepseek/deepseek-v4-pro` | `deepseek-v4-pro` |
| `moonshotai/kimi-k3.1-pro` | `kimi-k3.1-pro` |
| `qwen/qwen4-max` | `qwen4-max` |
| `z-ai/glm-5.3` | `glm-5.3` |
| `x-ai/grok-4.7` | `grok-4.7` |
| `minimax/minimax-m3.1-flash` | `MiniMax-M3.1-Flash` |

完整列表见[价格页](https://www.ruapi.ai/pricing?lng=zh-CN\&utm_source=docs\&utm_campaign=zh-openrouter-403-access-denied)，或者带上你的密钥请求 `GET https://www.ruapi.ai/v1/models`。此表截至 2026-11-21。

### 请求里还要去掉什么

| OpenRouter 的写法 | 在 RuAPI 里 |
| - | - |
| 请求头 `HTTP-Referer`、`X-Title` | 不需要，删掉 |
| 字段 `provider`、`models`（备用模型）、`transforms` | 不需要：由 RuAPI 选上游，某个渠道出故障时请求会自动转到备用渠道 |
| 模型名后缀 `:free`、`:nitro`、`:floor`、`:online` | 删掉，模型名不带后缀 |
| `reasoning: {"effort": "high"}` | 标准参数 `reasoning_effort: "high"`，GPT 和 Claude 都能用（[详见](https://docs.ruapi.ai/zh/openai-vs-anthropic-format.md)） |

## Claude Code 从 OpenRouter 换过来

按 [OpenRouter 的说明](https://openrouter.ai/docs/guides/coding-agents/claude-code-integration)（2026-11-21 核对），Claude Code 是这样配的：`ANTHROPIC_BASE_URL=https://openrouter.ai/api`，密钥放 `ANTHROPIC_AUTH_TOKEN`，`ANTHROPIC_API_KEY` 留空。换成 RuAPI 结构不变，只改值。RuAPI 直接收 Claude Code 原生的 Anthropic Messages 格式，不用装路由工具。

`~/.claude/settings.json` 里写：

```json theme={null}
{
  "model": "claude-sonnet-5-5",
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.ruapi.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的RuAPI密钥",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}
```

如果按 OpenRouter 的说明把变量写在了 `~/.zshrc` / `~/.bashrc`，或者项目里的 `.claude/settings.local.json`，把那里含 `openrouter.ai` 和 `OPENROUTER_API_KEY` 的行删掉：项目设置会盖过 `~/.claude/settings.json`。`anthropic/claude-opus-5.5[1m]`、`~anthropic/claude-opus-latest` 这类名字换成上表里的名字；如果设过 `ANTHROPIC_DEFAULT_FABLE_MODEL` 和 `CLAUDE_CODE_SUBAGENT_MODEL`，也一样换（比如 `claude-fable-5-2`、`claude-opus-5-5`）。`ANTHROPIC_BASE_URL` 末尾不要加 `/v1`。改完开一个新终端，运行 `/status`：`Anthropic base URL` 那一行应该是 `https://www.ruapi.ai`。完整配置见 [Claude Code 接入](https://docs.ruapi.ai/zh/integrations/claude-code.md)。

## 常见问题

> [accordion] 换新密钥或换个 OpenRouter 账号有用吗？
>
> 没用。请求是按发出的 IP 地址被拒的，还没轮到检查密钥。从同一个 IP 地址发，新密钥、新账号都会收到同样的 403。

> [accordion] 为什么在国外的同事用 OpenRouter 没问题？
>
> 因为他的请求来自别的国家的 IP。我们检测时，德国节点请求 `/api/v1/models` 拿到正常的模型列表，莫斯科和圣彼得堡节点收到的是 403。

> [accordion] RuAPI 上的模型和 OpenRouter 上的是同一批吗？
>
> 主要的都有：Claude、GPT、Gemini、DeepSeek、Kimi、Qwen、GLM、Grok 和 MiniMax（见上面的对照表）。都是原版模型，保持原生精度，没有另外量化。只是名字不一样。

> [accordion] 报错的不是我的代码，而是某个工具
>
> 在工具设置里去掉「OpenRouter」提供商，改接 RuAPI。Claude 走 Anthropic 协议，提示词缓存才生效；其他模型按「OpenAI Compatible」接。两种方式的密钥都是 RuAPI 密钥，模型名按上面的表填。地址有的工具填 `https://www.ruapi.ai`，有的填 `https://www.ruapi.ai/v1`，因为各工具拼接路径的方式不同；菜单名称也各不相同，所以请照对应的分步教程做：[Cline](https://docs.ruapi.ai/zh/integrations/cline.md)、[Kilo Code](https://docs.ruapi.ai/zh/integrations/kilo-code.md)、[Roo Code](https://docs.ruapi.ai/zh/integrations/roo-code.md)、[Continue](https://docs.ruapi.ai/zh/integrations/continue.md)。

## 接下来

> [card] [OpenRouter 替代方案](https://www.ruapi.ai/openrouter-alternativa?lng=zh-CN\&utm_source=docs\&utm_campaign=zh-openrouter-403-access-denied)
>
> RuAPI 和 OpenRouter 对比：付款、访问、余额退款。

> [card] [OpenRouter：怎么充值](https://docs.ruapi.ai/zh/pay-openrouter-russia.md)
>
> 从俄罗斯付款的办法、手续费和风险，付钱之前先看。

> [card] [如何用卢布购买 USDT](https://docs.ruapi.ai/zh/buy-usdt.md)
>
> 还没有 USDT？用卢布经 SBP 买，再充值 RuAPI。

> [card] [RuAPI 错误码](https://docs.ruapi.ai/zh/errors.md)
>
> 400、401、403、429 是什么意思、怎么解决。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.