快速开始

把任意 OpenAI 兼容客户端接到你的模型中转站。

你可以把 apillm 当成统一入口,背后再连接 OpenAI、OpenRouter、Tokln、Azure OpenAI 或其他兼容渠道。

Claude Code

Claude Code 接入

如果你希望团队开发环境统一走自建网关,可以在环境变量或配置文件里直接把 base URL 指向你的域名。

{
  "OPENAI_BASE_URL": "https://your-domain.example/v1",
  "OPENAI_API_KEY": "mg_xxx"
}

OpenAI SDK

JavaScript 示例

对大部分 OpenAI SDK 来说,只需要同时改两个参数:`apiKey` 和 `baseURL`。

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.MODELGATE_API_KEY,
  baseURL: "https://your-domain.example/v1",
});

const result = await client.chat.completions.create({
  model: "openrouter/auto",
  messages: [{ role: "user", content: "给我一份本周发布计划" }],
});

console.log(result.choices[0].message.content);

cURL

HTTP 调用示例

如果是服务端、脚本或自动化工具,直接请求 `/v1/chat/completions` 即可。

curl https://your-domain.example/v1/chat/completions \
  -H "Authorization: Bearer mg_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openrouter/auto",
    "messages": [{"role": "user", "content": "你好"}]
  }'

路由

渠道配置建议

  • 把对外模型名和上游模型名分开管理,例如 `claude-code` 映射到 `openrouter/anthropic/claude-sonnet-4`。
  • 优先给每个公开模型准备 2 条以上渠道路由,避免单点故障。
  • OpenRouter、Tokln 这类平台建议配置额外头,例如 `HTTP-Referer`、`X-Title`。
  • 按租户分别配置 RPM,避免单个客户挤占全局额度。