调用免费模型
api
- EndpointEndpoint
https://openrouter.ai/api/v1- 认证Authentication
- Authorization: Bearer API key
额度与限制Limits
调用额度与限流按提供商当前控制台和官方文档为准；免费条件可能按模型、账号和地区变化。
前置条件Prerequisites
- 已注册 OpenRouterOpenRouter
- 已创建 API keyAPI key
- 已从模型页确认当前免费模型 IDID
操作步骤Steps
- 创建 API key
进入 OpenRouter Keys 页面创建密钥，并将它放入 OPENROUTER_API_KEY 环境变量。
- 选择免费模型
在官方 Models 页面筛选价格为 0 的模型；免费标记和可用性会变化，不要长期写死目录中的模型。
操作Action：打开 https://openrouter.ai/models?max_price=0
- 发送 OpenAI 兼容请求
将 model 替换成模型页显示的完整 ID。
命令已在上方「快速上手」给出。The copyable command already appears in Quick start above.
预期结果Expected：响应包含 choices[0].message.content。
- Python SDK 示例
安装 OpenAI SDK；在运行环境设置 OPENROUTER_API_KEY，示例代码通过环境变量读取密钥。
可复制命令Copyable commandpython -m pip install -U openai import os from openai import OpenAI client = OpenAI( api_key=os.environ["OPENROUTER_API_KEY"], base_url="https://openrouter.ai/api/v1", ) response = client.chat.completions.create( model="openai/gpt-oss-20b:free", messages=[{"role": "user", "content": "用一句话解释 API 是什么。"}], ) print(response.choices[0].message.content)预期结果Expected：终端打印模型生成的回复；再到提供商控制台确认请求状态和额度扣减。
- Node.js SDK 示例
安装 OpenAI SDK；在运行环境设置 OPENROUTER_API_KEY，示例代码通过环境变量读取密钥。
可复制命令Copyable commandnpm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: process.env.OPENROUTER_API_KEY, baseURL: "https://openrouter.ai/api/v1", }); const response = await client.chat.completions.create({ model: "openai/gpt-oss-20b:free", messages: [{ role: "user", content: "用一句话解释 API 是什么。" }], }); console.log(response.choices[0].message.content);预期结果Expected：Node.js 打印模型生成的回复；再到提供商控制台确认请求状态和额度扣减。
验证动作Validation
GET /api/v1/models 返回 HTTP 200；随后聊天请求返回 choices 数组。
常见问题Common issues
- 401：检查 API Key、环境变量和认证 Header。401： API Key、 Header。
- 404：从官方模型清单复制当前模型 ID，并确认 endpoint 与账号地域一致。404： ID， endpoint 。
- 429：查看当前限流和配额重置说明，降低请求频率后再重试。429： ， 。