OpenAI SDK 接入

OpenAI SDK 适合在 Node.js 服务、脚本或后端应用中直接调用 Lumoswitch。配置 API 应提供 OpenAI-compatible 输出。

安装

pnpm add openai

配置环境变量

export LUMOSWITCH_BASE_URL="https://your-gateway.example.com/v1"
export LUMOSWITCH_API_KEY="your-lumoswitch-access-key"
export LUMOSWITCH_MODEL="your-public-model-name"

发起请求

import OpenAI from 'openai'
 
const client = new OpenAI({
  baseURL: process.env.LUMOSWITCH_BASE_URL,
  apiKey: process.env.LUMOSWITCH_API_KEY
})
 
const response = await client.chat.completions.create({
  model: process.env.LUMOSWITCH_MODEL,
  messages: [{ role: 'user', content: '用一句话介绍 Lumoswitch。' }]
})
 
console.log(response.choices[0].message.content)

model 必须使用配置 API 的对外模型名称，不要填写上游厂商的真实模型 ID。

流式输出

const stream = await client.chat.completions.create({
  model: process.env.LUMOSWITCH_MODEL,
  messages: [{ role: 'user', content: '写一个简短的欢迎语。' }],
  stream: true
})
 
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? '')
}

常见问题

401：确认 apiKey 是 Lumoswitch Access Key。
404：确认 baseURL 以 /v1 结尾，但没有重复的 /v1/v1。
模型不存在：调用 /models 并复制返回的对外模型名称。
浏览器报跨域：不要在公开前端直接保存 Access Key，应由后端代理调用。

通用接入 Codex