Quickstart · 5 minutes

5 分钟接入，所有 SDK 都能用

BlueRouter 完整兼容 OpenAI 协议。已有的 `openai`、`openai-node`、`langchain`、`vercel/ai`、`anthropic` SDK 全部可以直接用。

1. 创建账户

邮箱验证码注册 → 注册即送 $5 试用额度。

去注册

2. 生成 API Key

控制台 → API Keys → 新建。Key 只显示一次，请妥善保存。

进入控制台

3. 替换 base URL

将现有 OpenAI / Anthropic SDK 的 base URL 改为 https://api.bluerouter.dev/v1，完成。

查看代码

Base URL

把这一行作为你 SDK 的 base URL：

base url

https://api.bluerouter.dev/v1

cURL

先用 curl 验证联通性：

bash

curl https://api.bluerouter.dev/v1/chat/completions \
  -H "Authorization: Bearer $BLUEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [
      { "role": "user", "content": "Hello, BlueRouter!" }
    ],
    "stream": true
  }'

Python · openai SDK

已有 OpenAI 代码？只改一行 base_url：

python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.bluerouter.dev/v1",
    api_key="$BLUEROUTER_API_KEY",
)

stream = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello, BlueRouter!"}],
    stream=True,
)

for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="", flush=True)

Node.js · openai SDK

typescript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.bluerouter.dev/v1",
  apiKey: process.env.BLUEROUTER_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "anthropic/claude-3.5-sonnet",
  messages: [{ role: "user", content: "Hello, BlueRouter!" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

支持的模型

BlueRouter 路由到 OpenRouter 后台聚合的 200+ 模型，使用 OpenRouter 模型 ID 格式：

base url

# Browse the full catalog of 200+ models:
#   https://openrouter.ai/models
#
# Common ids you can drop in as the "model" field:
#   openai/gpt-4o          openai/gpt-4o-mini       openai/o1-preview
#   anthropic/claude-3.5-sonnet                     anthropic/claude-3-haiku
#   google/gemini-2.0-flash-001                     google/gemini-pro-1.5
#   deepseek/deepseek-chat deepseek/deepseek-reasoner
#   meta-llama/llama-3.3-70b-instruct
#   x-ai/grok-2-1212