获取豆包 AI API Key 并接入前端项目
豆包 AI 的大模型能力统一在 火山引擎·火山方舟（ARK） 平台开放。
一、准备工作
- 打开火山引擎官网：https://www.volcengine.com/
- 手机号注册并登录
- 进入右上角「账号管理」→ 完成实名认证
不实名认证无法使用 API 能力。
二、正式获取 API Key
步骤 1：进入火山方舟平台
登录后，顶部搜索框搜：火山方舟 或直接访问：https://console.volcengine.com/ark
步骤 2：创建 API Key
- 左侧菜单找到：API 密钥管理
- 点击 创建 API Key
- 起个名字，例如：
my-doubao-customer-service
创建成功后，立即复制保存 API Key 这个 key 只会显示一次！
格式示例：
ek-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
步骤 3：开通豆包 AI 模型
- 进入 模型管理中心
- 找到 豆包系列
- 推荐开通：
- Doubao-lite-128k（轻量、免费额度足、适合客服）
- Doubao-pro-256k（效果更好）
点击开通即可，无需复杂配置。
步骤 4：创建「推理接入点」获取 Endpoint ID
- 点击 创建推理接入点
- 填写名称：
doubao-chat - 选择刚才开通的豆包模型
- 地区选择：
cn-beijing
创建 → 等待状态变为 运行中
左侧进入：在线推理
创建完成后，复制：
ep-xxxxxxxxxxxxxxx
这就是你的 Endpoint ID。
三、前端接入代码示例（Vue3）
// 豆包 AI 接口请求
const replyFromDoubaoAI = async (userText) => {
try {
const res = await axios.post('https://ark.cn-beijing.volces.com/api/v3/chat/completions', {
model: '你的 EndpointID',
messages: [{ role: 'user', content: userText }]
}, {
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer 你的 APIKey'
}
});
return res.data.choices[0].message.content;
} catch (err) {
return 'AI 服务暂时不可用';
}
};
四、常见问题
- 调用报错 401：API Key 错误、未复制全、未开通模型。
- 报错 404 / Model not found：Endpoint ID 不对，或模型未运行。
- 免费额度能用多久？：个人新用户一般足够开发与小型项目使用。
- 可以直接前端调用吗？：学习、演示可以；正式上线建议通过后端中转，避免 API Key 泄露。
五、总结
本文介绍了如何获取豆包 AI API Key 及 Endpoint ID，并提供了前端接入代码示例。整个流程简单，10 分钟内可跑通。