OpenRouter 大模型对接
前置条件
已申请 OpenRouter API Key(申请地址:https://openrouter.ai/keys)
配置步骤
1. 获取 API Key
- 访问 OpenRouter 开发者平台:https://openrouter.ai/keys
- 注册并登录账号
- 在控制台创建 API Key
2. 管理后台配置
- 登录微语管理后台
3. 模型配置选择
- 进入 AI 模型配置页面
- 选择 OpenRouter 作为默认模型
- 保存配置
4. 获取聊天代码
- 在管理后台找到"获取聊天代码"选项
- 复制生成的代码
- 将代码集成到你的网站中
效果展示
配置完成后,你可以在网站中看到如下效果:

配置说明(可选)
Docker部署配置参数
# OpenRouter API 配置
SPRING_AI_OPENROUTER_BASE_URL: https://openrouter.ai/api # OpenRouter API 基础地址
SPRING_AI_OPENROUTER_API_KEY: 'sk-xxx' # 替换为你的 OpenRouter API Key
SPRING_AI_OPENROUTER_CHAT_ENABLED: true # 启用 OpenRouter 对话功能
# 模型配置
SPRING_AI_OPENROUTER_CHAT_OPTIONS_MODEL: openrouter/auto # 模型名称,可根据需求选择
SPRING_AI_OPENROUTER_CHAT_OPTIONS_TEMPERATURE: 0.7 # 温度参数,控制输出的随机性,范围 0-1
源码部署配置参数
# OpenRouter API 配置
spring.ai.openrouter.base-url=https://openrouter.ai/api # OpenRouter API 基础地址
spring.ai.openrouter.api-key=sk-xxx # 替换为你的 OpenRouter API Key
spring.ai.openrouter.chat.enabled=true # 启用 OpenRouter 对话功能
# 模型配置
spring.ai.openrouter.chat.options.model=openrouter/auto # 模型名称,可根据需求选择
spring.ai.openrouter.chat.options.temperature=0.7 # 温度参数,控制输出的随机性,范围 0-1
配置说明
- 将配置文件中的
sk-xxx
替换为你获取的 API Key - 根据实际需求调整 temperature 参数
- OpenRouter 支持多种模型,可根据需要选择合适的模型
常见问题
-
API Key 无效
- 检查 API Key 是否正确复制
- 确认 API Key 是否已激活
- 验证 API Key 的权限设置
-
对话响应慢
- 检查网络连接
- 确认服务器配置是否满足要求
- 可以适当调整 temperature 参数