OpenRouter

调用免费模型

api

EndpointEndpoint

https://openrouter.ai/api/v1

认证Authentication

Authorization: Bearer API key

前置条件Prerequisites

• 已注册 OpenRouterOpenRouter
• 已创建 API keyAPI key
• 已从模型页确认当前免费模型 IDID

操作步骤Steps

1. 创建 API key

   进入 OpenRouter Keys 页面创建密钥，并将它放入 OPENROUTER_API_KEY 环境变量。

2. 选择免费模型

   在官方 Models 页面筛选价格为 0 的模型；免费标记和可用性会变化，不要长期写死目录中的模型。

   操作Action：打开 https://openrouter.ai/models?max_price=0

3. 发送 OpenAI 兼容请求

   将 model 替换成模型页显示的完整 ID。

   可复制命令Copyable command复制命令Copy command

   export OPENROUTER_API_KEY="你的 Key"
   curl https://openrouter.ai/api/v1/chat/completions -H "Authorization: Bearer $OPENROUTER_API_KEY" -H 'Content-Type: application/json' --data '{"model":"openai/gpt-oss-20b:free","messages":[{"role":"user","content":"Hello"}]}'

   预期结果Expected：响应包含 choices[0].message.content。

4. Python SDK 示例

   安装 OpenAI SDK；在运行环境设置 OPENROUTER_API_KEY，示例代码通过环境变量读取密钥。

   可复制命令Copyable command复制命令Copy command

   python -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：终端打印模型生成的回复；再到提供商控制台确认请求状态和额度扣减。

5. Node.js SDK 示例

   安装 OpenAI SDK；在运行环境设置 OPENROUTER_API_KEY，示例代码通过环境变量读取密钥。

   可复制命令Copyable command复制命令Copy command

   npm 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 打印模型生成的回复；再到提供商控制台确认请求状态和额度扣减。

官方来源Official sources

• https://openrouter.ai/docs/quickstart ↗
• https://openrouter.ai/models?max_price=0 ↗
• https://openrouter.ai/docs/api-reference/overview ↗
• https://openrouter.ai/docs/api-reference/limits ↗