🚀 告别海外账号与网络限制!稳定直连全球优质大模型,限时半价接入中。 👉 点击领取海量免费额度
使用Node.js和OpenAI包接入Taotoken实现服务端AI功能
对于Node.js后端开发者而言,将大模型能力集成到Web服务中已成为提升应用智能水平的关键路径。通过Taotoken平台,你可以使用熟悉的openai npm包,以统一的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 dotenv
3. 编写核心调用代码
现在,我们来编写调用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并探索模型广场。
🚀 告别海外账号与网络限制!稳定直连全球优质大模型,限时半价接入中。 👉 点击领取海量免费额度
363

被折叠的 条评论
为什么被折叠?



