集成
OpenAI 兼容应用
用 Lovely Router API 密钥接入任意兼容 OpenAI 的应用、智能体框架或库:设置 base URL、密钥和模型 ID。
大多数调用 OpenAI 的应用、智能体框架和库都能调用 Lovely Router。Lovely Router 在 https://lovelyrouter.com/v1 为所有文本模型(包括 Claude 和 Gemini)提供 OpenAI Chat Completions API,因此一个自定义端点就能让应用用上全部模型。开始前,你需要先有一个 API 密钥。
设置项#
找到自定义端点的设置项,填入:
| 设置项 | 值 |
|---|---|
| Base URL | https://lovelyrouter.com/v1 |
| API 密钥 | 你的 lr-... 密钥 |
| 模型 | GET /v1/models 中的任意 ID,例如 gpt-6.1-sol 或 claude-sonnet-5.5 |
如果应用要求填写 API 地址(host)并会自行追加 /v1,请填 https://lovelyrouter.com,不带 /v1。
环境变量#
基于官方 OpenAI 或 Anthropic SDK 构建的工具,通常从环境变量读取 base URL:
Shell
# OpenAI SDK based tools
export OPENAI_BASE_URL=https://lovelyrouter.com/v1
export OPENAI_API_KEY=$LOVELY_API_KEY
# Anthropic SDK based tools
export ANTHROPIC_BASE_URL=https://lovelyrouter.com
export ANTHROPIC_API_KEY=$LOVELY_API_KEY自己写代码?SDK 中有 Python 和 Node.js 的客户端示例,OpenAI Chat Completions 介绍了流式输出、函数调用以及支持的功能。
故障排查#
| 现象 | 解决方法 |
|---|---|
401,消息为 Missing API key | 工具没有发送密钥。检查变量名,并确认你是在启动该工具的 Shell 中 export 的。 |
401,消息为 Invalid or revoked API key | 密钥输错、被截断或已吊销。重新粘贴,或创建一个新密钥。 |
404,消息为 Model '...' is not available | 该模型 ID 不存在。从 GET /v1/models 或模型列表中复制 ID。 |
404,消息为 Unknown endpoint | 工具调用了 Lovely Router 不提供的 API,例如 embeddings 或 audio。请把它切换到 Chat Completions、Responses API,或 Anthropic、Gemini 格式。 |
404,消息为 not served in responses format | Responses API 只提供 GPT 模型。请选择 gpt-* 模型,其他模型请使用 Chat Completions。 |
路径包含 /v1/v1/ 时返回 404 | 应用会自行追加 /v1。请把 https://lovelyrouter.com 填为地址。 |
402 | 余额已用完,或密钥已达到消费上限。请参阅额度与计费。 |
其他所有状态码请参阅错误。