推荐将火山引擎API Key配置为环境变量：先在控制台创建并保存Access/Secret Key，再通过系统环境变量或Node.js的dotenv加载到项目中，严禁硬编码；.env文件须加入.gitignore。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

把火山引擎API Key安全地配置进Node.js项目，避免密钥硬编码在代码里导致泄露或配额被盗用。

获取火山引擎API Key

登录火山引擎控制台 → 进入「火山方舟 → API Key 管理」→ 点击「创建API Key」→ 填写名称后创建 → 复制并立即保存 Access Key 和 Secret Key（【仅首次显示，丢失需重建】）。

注意：API Key 权限绑定当前项目空间，跨项目迁移模型后原 Key 将失效。

配置为环境变量（推荐）

方法一：Linux/macOS 临时生效（适合调试）
在终端执行：
export VOLC_ACCESS_KEY=your_access_key_here
export VOLC_SECRET_KEY=your_secret_key_here
export VOLC_BASE_URL=https://ark.cn-beijing.volces.com/api/v3

方法二：Linux/macOS 永久生效（生产环境必选）
编辑 ~/.bash_profile 或 ~/.zshrc，在末尾追加三行 export 语句 → 执行 source ~/.bash_profile（或 source ~/.zshrc）→ 运行 echo $VOLC_ACCESS_KEY 验证是否输出密钥。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

下载

方法三：Windows 系统配置
打开命令提示符 → 执行：
setx VOLC_ACCESS_KEY "your_access_key_here"
setx VOLC_SECRET_KEY "your_secret_key_here"
setx VOLC_BASE_URL "https://ark.cn-beijing.volces.com/api/v3"
【必须重启命令行窗口才能生效】

在Node.js项目中读取环境变量

第一步：项目根目录新建 .env 文件
第二步：写入以下内容（仅用于本地开发，不提交到 Git）：
VOLC_ACCESS_KEY=your_access_key_here
VOLC_SECRET_KEY=your_secret_key_here
VOLC_BASE_URL=https://ark.cn-beijing.volces.com/api/v3

第三步：安装 dotenv 包
npm install dotenv

第四步：在入口文件（如 index.js）顶部添加：
require('dotenv').config();
这行代码必须放在任何使用 process.env.VOLC_ACCESS_KEY 的逻辑之前，否则读不到值。

第五步：代码中安全调用
const apiKey = process.env.VOLC_ACCESS_KEY;
const secretKey = process.env.VOLC_SECRET_KEY;
const baseUrl = process.env.VOLC_BASE_URL;
确保 .env 已加入 .gitignore，防止密钥随代码上传。