OpenRouter API 怎么用？从 Key 到首次调用

OpenRouter API 接入先配对三项：OpenRouter 的 Key、https://openrouter.ai/api/v1 和目录中的模型 ID。 如果卡在官网或注册，先看 国内访问排查；本页覆盖 Key、充值和首次模型调用。

第一步：创建 Key，选好模型

登录 OpenRouter，在 Keys 创建密钥。到 模型目录 复制目标模型 ID，并检查价格、上下文和工具调用能力。需要免费测试时使用目录中实际可用的免费模型，不要自行给任意 ID 添加 :free。

OpenRouter 怎么充值？支持支付宝吗？

支持：截至 2026-09-09，OpenRouter 官方 FAQ 明确列出主要信用卡、AliPay（支付宝）和 USDC 加密货币支付。 这不是第三方代充说明；具体账户能看到的选项、手续费和到账额度仍应以官方结账页为准。FAQ 将 PayPal 描述为计划接入，不应写成已经支持。

1. 登录后进入 Credits 充值页，选择购买额度。
2. 在当次结账页选择可用支付方式，核对总扣款、手续费、美元额度及是否开启自动充值。
3. 支付后确认余额，再调用付费模型。购买额度与创建 API Key 是两件事。

如果付款方式没有出现，不要据此推断所有账户都不支持支付宝，也不要假定更换网络就一定能解决。保留结账页提示并向官方账单支持核实账户可用方式。

扣款后额度没到账怎么办？

官方 FAQ 提醒 Stripe 付款到账有时会延迟，可等待最多一小时。先检查扣款与收据，避免重复支付；已扣款仍未到账时，向官方 support@openrouter.ai 提供订单详情，不提供 API Key。加密货币付款问题同样应联系官方支持。

本页负责充值与 API 接入；官网打不开、登录失败或网络超时，请回到国内访问排查。

第二步：运行 Python 示例

安装客户端：

python -m pip install openai

在本地环境或密钥管理器中设置 OPENROUTER_API_KEY 和 OPENROUTER_MODEL；后者填刚才复制的模型 ID。不要把 Key 提交进代码仓库。

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.environ["OPENROUTER_API_KEY"],
    timeout=30.0,
)
response = client.chat.completions.create(
    model=os.environ["OPENROUTER_MODEL"],
    messages=[{"role": "user", "content": "用一句话介绍你能做什么"}],
)
print(response.choices[0].message.content)
print(response.usage)

示例使用 官方支持的 OpenAI SDK 接入方式。选付费模型时，请求会产生费用。确认有正常输出后，再接入长提示词或并发任务。

第三步：核对费用与免费限制

模型目录列出输入、输出等单价；账户 Activity 用于查看实际使用情况。购买额度时还应核对结账页费用，不要把模型 token 单价等同于最终充值成本。计费方式见 官方 FAQ。

免费模型通常限制为每分钟 20 次、每天 50 次；累计购买至少 10 美元额度后，每日上限为 1,000 次。此规则针对免费模型，不是所有付费模型的通用配额。

数据核对于 2026-09-07，见 官方免费模型说明。免费额度不是稳定吞吐承诺；上线前用实际模型验证容量。

调用失败先看什么

限额与计费错误以 OpenRouter 文档 为准。详细处理见 429 怎么解决 和 API 报错速查。

接入编辑器或切换平台

工具有 OpenRouter 原生选项时优先按其配置界面填写；使用自定义端点时，先确认工具要求的是 Chat Completions、Responses 还是 Anthropic 协议，不能只替换 URL。

编辑器配置见 Cursor、Windsurf 和 Roo Code 接入说明。考虑切换到 OfoxAI 时，按 迁移说明 逐项核对 Key、端点、模型 ID 和协议，再验证调用及账单。