必须完成密钥获取、环境配置、依赖安装和代码初始化四步,否则返回401错误;需在火山引擎方舟平台创建api密钥、复制模型id、设置正确baseurl,安装指定依赖并配置.env与index.js,运行后输出回复即成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要用火山引擎API创建一个可交互的聊天机器人,必须先完成密钥获取、环境配置、依赖安装和代码初始化四步,缺一不可,否则后续所有请求都会返回401错误。
获取火山引擎方舟平台API密钥
登录火山引擎方舟平台控制台,在【API密钥管理】中点击「创建密钥」,生成 VOLC_API_KEY;在【模型服务】页找到已开通的模型,复制其接入点 ID 作为 VOLC_MODEL;基础地址固定为 https://ark.cn-beijing.volces.com/api/v3。
注意:VOLC_BASE_URL 必须带末尾 /v3,漏写会导致 404;密钥一旦关闭或轮换,本地 .env 中的值必须同步更新,否则机器人会静默失败。
初始化项目并安装兼容依赖
新建空文件夹,执行:npm init -y → npm install @langchain/openai @langchain/core dotenv。
若使用 Node.js 16 或 17,必须额外执行:npm install web-streams-polyfill,否则流式响应会卡死或抛出 TypeError: ReadableStream is not a constructor。
这一步操作起来很简单,直接把命令粘贴进终端回车就行。
配置环境变量与核心代码
在项目根目录新建 .env 文件,填入:
VOLC_API_KEY=ak-xxxVOLC_MODEL=ep-xxxVOLC_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
新建 index.js,写入以下代码(已适配 Node 16+ 全版本):
import { ChatVolcEngine } from "@langchain/openai";import { RunnableSequence } from "@langchain/core/runnables";import { HumanMessage } from "@langchain/core/messages";import * as dotenv from "dotenv";dotenv.config();const model = new ChatVolcEngine({ modelName: process.env.VOLC_MODEL, configuration: { apiKey: process.env.VOLC_API_KEY, baseURL: process.env.VOLC_BASE_URL, },});(async () => { const res = await model.invoke([new HumanMessage("你好")]); console.log(res.content);)();
运行 node index.js,终端输出“你好”对应的回复即表示集成成功。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











