Lovely Router文档
获取密钥
快速入门

快速开始

创建 API 密钥,用你已在使用的 SDK 发出第一个请求,并查看它的花费。

你需要一个账户和一个 API 密钥。在 X 上发帖介绍 Lovely Router 即可获得 $2 免费额度,足够向小模型发出数百次请求(如何领取)。

  1. 创建 API 密钥

    注册后,在控制台中打开 API 密钥,点击 新建密钥。请立即复制密钥:它以 lr- 开头,且只显示一次。

    把它保存在环境变量中,避免写进代码:

    Shell
    export LOVELY_API_KEY="lr-..."
  2. 发出第一个请求

    Lovely Router 原生支持 Anthropic、OpenAI 和 Gemini API。选择你的代码已经在用的那一种,只需更换 base URL 和密钥。

    curl https://lovelyrouter.com/v1/chat/completions \
      -H "Authorization: Bearer $LOVELY_API_KEY" \
      -H "content-type: application/json" \
      -d '{
        "model": "gpt-6.1-sol",
        "messages": [{"role": "user", "content": "Write a haiku about routers."}]
      }'

    同一个密钥可用于所有模型。如需用 Anthropic SDK 调用 Claude,或用 Google SDK 调用 Gemini,请参阅 Anthropic Messages 和 Gemini。

  3. 流式接收响应

    加上 stream: true,即可在 token 生成的同时接收它们。流式输出的用法与厂商自己的 API 完全相同。

    curl -N https://lovelyrouter.com/v1/chat/completions \
      -H "Authorization: Bearer $LOVELY_API_KEY" \
      -H "content-type: application/json" \
      -d '{"model": "gpt-6.1-sol", "stream": true,
           "messages": [{"role": "user", "content": "Count to ten, slowly."}]}'
  4. 查看费用

    每个请求都会在几秒内出现在日志中,附带 token 数、扣费、首字延迟和吞吐。每个响应还带有 x-lovely-request-id 响应头。就某次调用联系支持时,请附上它。

选择模型#

调用 GET /v1/models 获取实时模型列表,包含上下文长度和价格;也可以浏览模型广场。模型 ID 的写法很宽松:claude-sonnet-5.5、claude-sonnet-5-5 和 anthropic/claude-sonnet-5.5 都会解析为同一个模型。

cURL
curl https://lovelyrouter.com/v1/models

后续步骤#