集成

SDK

用 Lovely Router API 密钥使用官方 OpenAI、Anthropic 和 Google Gen AI SDK：创建客户端时传入 base URL 和密钥。

Lovely Router 以原生格式提供 OpenAI、Anthropic 和 Gemini API，因此官方 SDK 可以直接使用。创建客户端时传入 base URL 和你的密钥，其余一切按厂商文档操作即可。开始前，你需要先有一个 API 密钥。

API 密钥页面 接入客户端 中的 cURL / SDK 标签页提供了已填入你密钥的现成示例。

OpenAI SDK#

Python

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://lovelyrouter.com/v1",
    api_key=os.environ["LOVELY_API_KEY"],
)
response = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

Chat Completions 接受所有文本模型，因此同一个客户端也可以调用 claude-sonnet-5.5 或 gemini-3.1-pro。

Anthropic SDK#

Python

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://lovelyrouter.com",
    api_key=os.environ["LOVELY_API_KEY"],
)
message = client.messages.create(
    model="claude-sonnet-5.5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(message.content[0].text)

Google Gen AI SDK#

Python

import os
from google import genai
from google.genai import types

client = genai.Client(
    api_key=os.environ["LOVELY_API_KEY"],
    http_options=types.HttpOptions(base_url="https://lovelyrouter.com"),
)
response = client.models.generate_content(model="gemini-3.1-pro", contents="Hello")
print(response.text)

各格式的更多说明：Anthropic Messages、OpenAI Chat Completions、Gemini。

故障排查#

现象	解决方法
`401`，消息为 `Missing API key`	客户端没有发送密钥。检查运行代码的环境中是否设置了 `LOVELY_API_KEY`。
`401`，消息为 `Invalid or revoked API key`	密钥输错、被截断或已吊销。重新粘贴，或创建一个新密钥。
`404`，消息为 `Model '...' is not available`	该模型 ID 不存在。从 `GET /v1/models` 或模型列表中复制 ID。
路径包含 `/v1/v1/` 时返回 `404`	Anthropic SDK 会自行追加 `/v1`。请把 `https://lovelyrouter.com` 作为它的 base URL；只有 OpenAI SDK 使用 `https://lovelyrouter.com/v1`。
`402`	余额已用完，或密钥已达到消费上限。请参阅额度与计费。

其他所有状态码请参阅错误。