SDK 与客户端
使用 OpenAI SDK 接入 iRouter
在 Python 和 Node.js 中配置兼容接口并发送文本请求。
准备
准备 Python 或 Node.js 环境和 iRouter API 密钥,从控制台目录选择支持 Chat Completions 的模型。将 <model-id> 替换为该线路允许调用的完整模型 ID。
配置
在运行程序的终端设置环境变量。以下 API 地址来自当前网关配置,包含 /v1。
export IROUTER_API_BASE='https://gateway.irouter.io/v1'
export IROUTER_API_KEY='<your-irouter-api-key>'
export IROUTER_MODEL='<model-id>'PowerShell 使用对应的环境变量语法。
$env:IROUTER_API_BASE = 'https://gateway.irouter.io/v1'
$env:IROUTER_API_KEY = '<your-irouter-api-key>'
$env:IROUTER_MODEL = '<model-id>'Python
运行 python -m pip install openai,将以下代码保存为 example.py。
import os
from openai import OpenAI
client = OpenAI(
base_url=os.environ["IROUTER_API_BASE"],
api_key=os.environ["IROUTER_API_KEY"],
)
result = client.chat.completions.create(
model=os.environ["IROUTER_MODEL"],
messages=[{"role": "user", "content": "Reply with a short greeting."}],
)
print(result.choices[0].message.content)Node.js
运行 npm install openai,将以下代码保存为 example.mjs。
import OpenAI from 'openai';
const { IROUTER_API_BASE, IROUTER_API_KEY, IROUTER_MODEL } = process.env;
if (!IROUTER_API_BASE || !IROUTER_API_KEY || !IROUTER_MODEL) {
throw new Error('Set IROUTER_API_BASE, IROUTER_API_KEY, and IROUTER_MODEL');
}
const client = new OpenAI({ baseURL: IROUTER_API_BASE, apiKey: IROUTER_API_KEY });
const result = await client.chat.completions.create({
model: IROUTER_MODEL,
messages: [{ role: 'user', content: 'Reply with a short greeting.' }],
});
console.log(result.choices[0].message.content);验证
在设置环境变量的同一个终端运行 python example.py 或 node example.mjs。收到文本后,在控制台「用量明细」核对模型和调用记录,费用按实际模型与线路结算。
排查
检查程序继承的环境变量、密钥状态、模型协议、线路和 IP 白名单。Python 的参数名为 base_url,Node.js 的参数名为 baseURL。通过 SDK 错误中的状态码和请求标识定位失败,分享诊断信息前移除密钥。
参考
SDK 的安装和客户端配置见官方参考,网关地址与模型以 iRouter 配置为准。Python SDK · Node.js SDK