Skip to main content

4. OpenRouter大模型API聚合平台文字交互

4. OpenRouter大模型API聚合平台文字交互概念介绍1.1 “OpenRouter”是什么？2. 实践操作2.1 获取API凭证2.2图文流程2.3 配置文件修改

概念介绍​

1.1 “OpenRouter”是什么？​

OpenRouter是一个大模型API聚合平台 。你可以把它想象成一个“大模型的万能遥控器”。通常情况下，如果你想使用OpenAI的GPT-4、Anthropic的Claude-3和Google的Gemini，你需要分别注册三个平台的账号、获取三套API Key，并针对它们各自不同的API格式编写三套不同的调用代码。

而OpenRouter解决了这个问题。它提供一个统一的API接口 （与OpenAI的API格式兼容），你只需要一个OpenRouter的API Key，就可以通过这一个入口调用上述所有模型以及其他上百种开源和闭源模型。

在largemodel项目中集成OpenRouter的核心优势 在于：

  • 极致的灵活性 : 可以通过修改配置文件中的一个模型名称，无缝切换GPT、Claude、Llama等任意模型，而无需改动任何代码。

  • 成本效益 : OpenRouter为每个模型都提供了清晰的定价，你可以方便地比较和选择性价比最高的模型来执行特定任务。

  • 探索前沿模型 : 许多新的、优秀的开源模型会第一时间被OpenRouter收录，方便开发者快速尝鲜。

在largemodel项目中，通过配置llm_platform参数为openrouter，即可启用这个强大的聚合平台。

2. 实践操作​

2.1 获取API凭证​

  1. 注册OpenRouter : 访问OpenRouter.ai，使用Google或邮箱注册一个账号，如果连接失效，需要自己去搜索"OpenRouter"平台。

  2. 充值 : OpenRouter采用预付费模式。你需要先在"Credits"页面充值少量金额（例如5美元）才能开始使用。或者直接使用它免费提供的模型，但是有速率限制。

  3. 创建API Key : 在"Keys"页面，点击“Create Key”生成一个新的API Key，并立即复制并保存好 。

2.2图文流程​

1.先进入以下网站 如果连接失效，需要自己去搜索"OpenRouter"平台，然后再寻找大模型的关键字。

OpenRouter

image-20250801163705985

2.注册登录一下账号

3.注册完账号点击进入模型广场

image-20250801165400079

4.可以在搜索栏里输入free，就可以找到可以免费调用的模型。

image-20250807175353717

5.将鼠标放在模型旁边的剪辑板图标上，就可以看到调用模型时要用的名称，点击一下就可以复制下来。

image-20250807175436229

6.鼠标移至右上角头像旁边，会展开，可以点击Keys，进去创建一个key。

image-20250807180439598

7.点击申请api key

image-20250807180556227

8.申请之后会得到一串api key

image-20250801171806192

2.3 配置文件修改​

  1. 打开large_model_interface.yaml:

xxxxxxxxxx vim ~/yahboom_ws/src/largemodel/config/large_model_interface.yaml

然后在openrouter_api_key将sk-xxxxxxxxxx改为你刚才复制的api key。

openrouter_model用于配置对话时的大模型。

xxxxxxxxxx # OpenRouter平台配置 (OpenRouter Platform Configuration) openrouter_api_key: "sk-xxxxxxxxxxxxxxxxxxx" openrouter_model: "moonshotai/kimi-k2:free" # 使用的模型，例如 "google/gemini-pro-vision" 2. 打开yahboom.yaml:

xxxxxxxxxx vim ~/yahboom_ws/src/largemodel/config/yahboom.yaml 3. 切换平台 : 将llm_platform参数修改为openrouter。

llm_platform : 'openrouter'

切换好平台参数之后，重新回到工作空间下再次编译即可生效。