SDK 与客户端
准备本地运行环境
选择终端,检查 Node.js、Python、curl 与环境变量。
选择终端
文档中标记 bash 的命令用于 Bash;Windows 可以使用 WSL 或 Git Bash。标记 powershell 的命令用于 PowerShell,不要混用反斜线与 PowerShell 续行符。
Windows 的 curl 在部分环境中可能是别名。调用系统 curl 时使用 curl.exe;也可以按 curl 接入指南使用 Invoke-RestMethod。
检查依赖
使用 Node.js SDK 或基于 npm 安装的客户端时,从 Node.js 官网选择客户端支持的 LTS 版本。使用 Python 示例时安装依赖支持的 Python 版本,建议为项目创建独立虚拟环境。
node --version
npm --version
python --version只检查自己使用的运行时。命令不存在时先完成官方安装,重新打开终端确认 PATH,不需要为了运行 curl 而同时安装所有 SDK。
设置会话变量
Bash 示例:
export IROUTER_API_KEY='<your-irouter-api-key>'
export IROUTER_MODEL='<model-id>'
export IROUTER_API_BASE='https://gateway.irouter.io/v1'PowerShell 示例:
$env:IROUTER_API_KEY = '<your-irouter-api-key>'
$env:IROUTER_MODEL = '<model-id>'
$env:IROUTER_API_BASE = 'https://gateway.irouter.io/v1'替换两个占位符后,在同一终端启动程序。这些命令设置当前进程及其后续子进程的环境,不会自动更新已经运行的 IDE 或后台服务。
排查环境问题
命令找不到时检查安装路径;配置未生效时检查启动程序的终端;出现中文乱码时以 UTF-8 保存脚本和请求文件。不要通过关闭 TLS 证书验证修复连接问题。继续阅读 OpenAI SDK 或对应客户端教程。