🚀 告别海外账号与网络限制!稳定直连全球优质大模型,限时半价接入中。 👉 点击领取海量免费额度
使用Node.js和OpenAI包接入Taotoken实现服务端AI功能
对于Node.js后端开发者而言,将大模型能力集成到Web服务中已成为提升应用智能水平的关键路径。通过Taotoken平台,你可以使用熟悉的openainpm包,以统一的OpenAI兼容API接入多家主流模型,简化开发流程。本文将指导你完成从环境配置到服务集成的完整步骤。
1. 准备工作:获取API Key与选择模型
开始编码前,你需要在Taotoken平台完成两项基础配置。
首先,访问Taotoken控制台,创建一个API Key。这个Key将作为你所有API请求的身份凭证,请妥善保管。建议为不同的应用或环境创建独立的Key,便于后续的权限管理与用量追踪。
其次,前往平台的模型广场,浏览并选择适合你当前需求的模型。每个模型都有一个唯一的标识符,例如claude-sonnet-4-6或gpt-4o-mini。在后续的代码中,你将通过这个model参数来指定使用哪个模型。模型广场会展示各模型的基本信息,帮助你做出选择。
完成这两步后,你就拥有了调用所需的一切信息:API Key和模型ID。
2. 项目初始化与环境变量配置
我们从一个干净的Node.js项目开始。创建一个新的项目目录,并初始化package.json文件。
mkdir taotoken-node-demo cd taotoken-node-demo npm init -y接下来,安装官方OpenAI Node.js库。这个库提供了与OpenAI API兼容的客户端,经过简单配置即可对接Taotoken。
npm install openai为了安全地管理敏感信息,避免将API Key硬编码在代码中,我们使用环境变量。在项目根目录下创建一个名为.env的文件,并填入你的Taotoken API Key。
TAOTOKEN_API_KEY=你的实际API Key同时,创建一个.gitignore文件,确保.env不会被提交到版本控制系统。
node_modules .env在代码中,我们将使用dotenv包来读取这个环境变量。虽然这不是必须的,但它是Node.js社区的常见实践。
npm install dotenv3. 编写核心调用代码
现在,我们来编写调用Taotoken聊天补全接口的核心代码。创建一个名为index.js的文件。
首先,加载环境变量并初始化OpenAI客户端。关键在于正确设置baseURL参数,将其指向Taotoken的OpenAI兼容聚合端点。
import OpenAI from 'openai'; import * as dotenv from 'dotenv'; dotenv.config(); const client = new OpenAI({ apiKey: process.env.TAOTOKEN_API_KEY, baseURL: 'https://taotoken.net/api', });请注意,baseURL的值是https://taotoken.net/api。OpenAI SDK会自动在此基础URL后拼接/v1/chat/completions等具体的API路径。这是对接Taotoken与对接原厂OpenAI在配置上的主要区别。
接下来,我们编写一个异步函数来发起聊天请求。这个函数封装了调用过程,便于在Web服务路由中复用。
async function callChatCompletion(model, userMessage) { try { const completion = await client.chat.completions.create({ model: model, messages: [{ role: 'user', content: userMessage }], // 可根据需要添加其他参数,如 temperature、max_tokens 等 }); return completion.choices[0]?.message?.content || '未收到回复内容'; } catch (error) { console.error('调用AI接口时发生错误:', error); throw error; // 或将错误信息封装后返回 } }函数接收两个参数:model(模型ID)和userMessage(用户输入)。它使用初始化好的client发起请求,并返回模型生成的回复内容。错误处理部分确保了服务的健壮性。
4. 集成到Web服务框架
有了核心调用函数,我们可以轻松地将其集成到Express、Koa或Fastify等Web框架中。以下是一个使用Express.js创建简单API端点的示例。
首先,安装Express。
npm install express然后,创建或修改index.js文件,构建一个完整的Web服务。
import express from 'express'; import OpenAI from 'openai'; import * as dotenv from 'dotenv'; dotenv.config(); const app = express(); const port = process.env.PORT || 3000; app.use(express.json()); // 用于解析JSON格式的请求体 const client = new OpenAI({ apiKey: process.env.TAOTOKEN_API_KEY, baseURL: 'https://taotoken.net/api', }); app.post('/api/chat', async (req, res) => { const { model = 'claude-sonnet-4-6', message } = req.body; if (!message) { return res.status(400).json({ error: '缺少 message 参数' }); } try { const completion = await client.chat.completions.create({ model: model, messages: [{ role: 'user', content: message }], }); const reply = completion.choices[0]?.message?.content; res.json({ model, reply }); } catch (error) { console.error('API调用失败:', error); res.status(500).json({ error: 'AI服务处理请求时出错' }); } }); app.listen(port, () => { console.log(`服务已启动,监听端口 ${port}`); });这个服务暴露了一个POST /api/chat端点。客户端可以通过请求体传递model和message参数,服务端会通过Taotoken调用指定模型并返回结果。你可以在此基础上添加身份验证、限流、更复杂的对话历史管理等功能。
5. 运行测试与后续步骤
启动你的Web服务进行测试。
node index.js使用curl或Postman等工具发送一个测试请求。
curl -X POST http://localhost:3000/api/chat \ -H "Content-Type: application/json" \ -d '{"message":"你好,请简单介绍一下你自己"}'如果一切配置正确,你将收到来自所选大模型的回复。至此,你已经成功使用Node.js和OpenAI包接入了Taotoken,并构建了一个具备AI能力的Web服务后端。
后续,你可以通过Taotoken控制台的用量看板监控各API Key的Token消耗与费用情况。对于团队协作场景,可以在平台上管理多个Key并设置不同的访问权限。当需要切换模型时,只需在代码或请求参数中更改model字段的值即可,无需修改任何基础设施代码。
开始你的集成之旅,可以访问 Taotoken 创建API Key并探索模型广场。
🚀 告别海外账号与网络限制!稳定直连全球优质大模型,限时半价接入中。 👉 点击领取海量免费额度