# 完成第一次模型调用

来源: https://platform.lyrouter.com/ai_gateway/docs/quickstart
更新日期: 2026-10-13

使用 LYRouter 的 OpenAI 兼容接口完成一次模型调用，再在控制台确认请求结果和用量。

## 1. 准备账号与 API Key

注册并选择个人版后，使用默认工作空间。团队与企业成员选择被授权的工作空间。

### 创建并保存 API Key

在当前工作空间的左侧导航选择 **API 密钥**，进入密钥列表，点击右上角的 **创建 API 密钥**，按步骤完成配置并生成密钥。

（截图：API 密钥 WEB 页面，左侧 API 密钥导航已选中，正文显示密钥列表，右上角是创建 API 密钥按钮）

在创建成功的弹窗中点击 **复制**，安全保存完整密钥，再勾选已保存确认；明文只展示一次，关闭后无法再次查看。

（截图：API 密钥创建成功后的保存弹窗，包含一次性展示提示、复制按钮和已保存确认框）

### 选择模型并复制模型标识

在模型广场确认一个模型已启用且有有效来源，复制系统模型标识，替换示例中的 `MODEL_ID`。本篇默认按平台模型接入；已有供应商凭证时阅读[BYOK](https://platform.lyrouter.com/ai_gateway/docs/byok-choice)。

（截图：工作空间模型广场，展示已启用模型、系统模型标识旁的复制按钮和服务商来源）

## 2. 准备调用环境

选择你的操作系统，安装准备使用的调用方式所需工具。使用 cURL 只需准备 cURL；选择 Python 或 Node.js 时，再安装对应运行环境和 SDK。已有工具可跳过安装，先检查版本。

**选择操作系统**

Windows:
以下命令在 **PowerShell** 中执行，适用于 Windows 10 / 11。

#### 1. 准备 cURL

Windows 10 / 11 通常已自带 cURL，先检查：

```powershell
curl.exe --version
```

若提示找不到命令，通过 WinGet 安装后重新打开终端：

```powershell
winget install --id cURL.cURL --exact --source winget
```

使用 `curl.exe`，避免 Windows PowerShell 将 `curl` 解释为其他命令。没有 WinGet 时可安装 [App Installer](https://learn.microsoft.com/windows/package-manager/winget/)，或从 [cURL 官网](https://curl.se/windows/)下载并将解压后的 `bin` 目录加入用户 PATH。

#### 2. 安装 Python 与 SDK（选择 Python 时）

```powershell
winget install --id Python.Python.3.14 --exact --source winget
```

安装后重新打开 PowerShell，在用于示例的项目目录中执行：

```powershell
python --version
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install openai
```

将下节 Python 示例保存为 `example.py`，使用 `.\.venv\Scripts\python.exe example.py` 运行。这里直接使用虚拟环境中的 Python，无需修改 PowerShell 的脚本执行策略。

#### 3. 安装 Node.js 与 SDK（选择 Node.js 时）

安装 Node.js LTS，npm 会随其安装：

```powershell
winget install --id OpenJS.NodeJS.LTS --exact --source winget
```

安装后重新打开 PowerShell，在用于示例的项目目录中执行。已有 `package.json` 时跳过初始化：

```powershell
node --version
npm.cmd --version
npm.cmd init -y
npm.cmd install openai
```

将下节 Node.js 示例保存为 `example.mjs`，使用 `node example.mjs` 运行。使用 `npm.cmd` 可避免 PowerShell 对 `npm.ps1` 的执行策略限制。没有 WinGet 时，也可使用 [Python](https://www.python.org/downloads/windows/) 和 [Node.js LTS](https://nodejs.org/en/download) 的官方安装程序。

#### 4. 设置当前终端的环境变量

```powershell
$env:LYROUTER_API_KEY="YOUR_LYROUTER_API_KEY"
$env:LYROUTER_BASE_URL="https://api.lyrouter.com"
```

Linux:
以下命令在 **Bash** 中执行。系统包安装需要 `sudo` 权限；下面提供 Ubuntu / Debian 与 Fedora / Rocky Linux 的对应命令。

#### 1. 安装 cURL 和 Python

Ubuntu / Debian：

```bash
sudo apt update
sudo apt install -y curl python3 python3-pip python3-venv
```

Fedora / Rocky Linux：

```bash
sudo dnf install -y curl python3 python3-pip
```

```bash
curl --version
python3 --version
```

只使用 cURL 时，可在安装命令中仅保留 `curl`。

#### 2. 安装 Python SDK（选择 Python 时）

在用于示例的项目目录中创建并激活虚拟环境：

```bash
python3 -m venv .venv
source .venv/bin/activate
python -m pip install openai
```

将下节 Python 示例保存为 `example.py`，在已激活虚拟环境的终端中运行 `python example.py`。

#### 3. 安装 Node.js 与 SDK（选择 Node.js 时）

通过 [nvm](https://github.com/nvm-sh/nvm#installing-and-updating) 安装 Node.js LTS，避免系统仓库中的旧版 Node.js。已有 nvm 时跳过第一条命令：

```bash
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash
```

重新打开终端后执行：

```bash
nvm install --lts
nvm use --lts
node --version
npm --version
```

在用于示例的项目目录中安装 SDK；已有 `package.json` 时跳过初始化：

```bash
npm init -y
npm install openai
```

将下节 Node.js 示例保存为 `example.mjs`，运行 `node example.mjs`。以上 Node.js 路径适用于常见的 glibc 发行版；Alpine 等环境请按 [Node.js 下载页](https://nodejs.org/en/download)选择对应安装方式。

#### 4. 设置当前终端的环境变量

```bash
export LYROUTER_API_KEY="YOUR_LYROUTER_API_KEY"
export LYROUTER_BASE_URL="https://api.lyrouter.com"
```

macOS:
打开 **终端（Terminal）**，以下命令适用于 Bash / Zsh。

#### 1. 准备 cURL 与 Homebrew

macOS 已自带 cURL，先检查；可直接用于本节调用：

```bash
curl --version
```

Python 和 Node.js 可以通过 [Homebrew](https://brew.sh/) 安装。若尚未安装 Homebrew，执行其官方安装命令，并按照安装完成后的 **Next steps** 提示配置 PATH：

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

若需要单独安装新版 cURL，可执行 `brew install curl`。Homebrew 的 cURL 为 keg-only，按 `brew info curl` 的提示配置 PATH 后重新检查版本。

#### 2. 安装 Python 与 SDK（选择 Python 时）

```bash
brew install python
python3 --version
```

在用于示例的项目目录中创建并激活虚拟环境，再安装 SDK：

```bash
python3 -m venv .venv
source .venv/bin/activate
python -m pip install openai
```

将下节 Python 示例保存为 `example.py`，在已激活虚拟环境的终端中运行 `python example.py`。

#### 3. 安装 Node.js 与 SDK（选择 Node.js 时）

安装 Node.js 24 LTS，并将其加入当前终端的 PATH：

```bash
brew install node@24
export PATH="$(brew --prefix node@24)/bin:$PATH"
node --version
npm --version
```

在用于示例的项目目录中安装 SDK；已有 `package.json` 时跳过初始化：

```bash
npm init -y
npm install openai
```

将下节 Node.js 示例保存为 `example.mjs`，运行 `node example.mjs`。新终端也要使用此 Node.js 版本时，按 `brew info node@24` 的提示配置 shell 启动文件。

#### 4. 设置当前终端的环境变量

```bash
export LYROUTER_API_KEY="YOUR_LYROUTER_API_KEY"
export LYROUTER_BASE_URL="https://api.lyrouter.com"
```

将 `YOUR_LYROUTER_API_KEY` 替换为刚保存的密钥。以上示例使用 LYRouter 公网网关 `https://api.lyrouter.com`；自部署时替换为你的网关地址。环境变量只对当前终端及其启动的程序生效；重新打开终端后需再次设置。Base URL 保存网关根地址，不带末尾 `/v1`，不要使用控制台 `/ai_gateway/` 页面地址。

参考：[Python 虚拟环境](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/)、[Windows Python 安装](https://learn.microsoft.com/windows/dev-environment/python)、[Node.js 下载](https://nodejs.org/en/download)、[Homebrew](https://brew.sh/)。

## 3. 发起请求

**选择调用语言**

cURL:
**Linux / macOS（Bash / Zsh）**

```bash
curl "$LYROUTER_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $LYROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID","messages":[{"role":"user","content":"请回复 OK"}]}'
```

**Windows（PowerShell）**

通过标准输入传递 JSON，避免 PowerShell 的引号转义差异。将 `MODEL_ID` 替换为你的系统模型标识：

```powershell
$body = @'
{"model":"MODEL_ID","messages":[{"role":"user","content":"Reply OK"}]}
'@
$body | curl.exe "$env:LYROUTER_BASE_URL/v1/chat/completions" `
  -H "Authorization: Bearer $env:LYROUTER_API_KEY" `
  -H "Content-Type: application/json" `
  --data-binary "@-"
```

Python:
```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LYROUTER_API_KEY"],
    base_url=os.environ["LYROUTER_BASE_URL"] + "/v1",
)
result = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "请回复 OK"}],
)
print(result.choices[0].message.content)
```

Node.js:
```javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LYROUTER_API_KEY,
  baseURL: process.env.LYROUTER_BASE_URL + "/v1",
});
const result = await client.chat.completions.create({
  model: "MODEL_ID",
  messages: [{ role: "user", content: "请回复 OK" }],
});
console.log(result.choices[0].message.content);
```

## 4. 验证结果

确认返回回复，再进入日志分析核对生成请求的状态、模型和 Token 用量。找不到模型时检查工作空间来源与[模型标识](https://platform.lyrouter.com/ai_gateway/docs/model-names)；401 / 403 见[鉴权排查](https://platform.lyrouter.com/ai_gateway/docs/auth-errors)，429 见[配额排查](https://platform.lyrouter.com/ai_gateway/docs/rate-errors)。

下一步可以[接入编程工具](https://platform.lyrouter.com/ai_gateway/docs/tools)，或查看[API 文档](https://platform.lyrouter.com/ai_gateway/docs/chat-completions)中的参数和进阶调用方式。
