豆包 AI 是字节跳动旗下火山引擎推出的大型中文语言模型和人工智能服务平台。集成了文本生成、图像合成、视频制作、数据分析等多种 AI 能力，支持多模态交互。具备超大上下文窗口（最高支持 256k tokens），适合处理长文本、复杂对话和知识推理。通过 API 和 SDK 形式，方便开发者和企业集成到各类应用中。

豆包 API 调用教程（2025 最新）

一、环境准备

• 注册并实名认证： ? ?访问 火山引擎控制台 创建账号并完成实名认证。
• 开通模型： ? ?推荐使用 Doubao-pro-32k 或 Doubao-lite-32k 模型，开通后可获得免费 Token。
• 获取 API Key： ? ?在控制台 API Key 管理中创建密钥，保存在项目的环境变量中。
• 创建接入点： ? ?在模型推理页面创建接入点，记录形如 ep-xxxxxx 的 ID。

二、调用方式（JavaScript）

• 安装 SDK：

npm install @volcengine/ark-runtime登录后复制

• 调用示例代码：

import { ArkService } from ”@volcengine/ark-runtime“;import { ChatCompletionRequest, ChatMessageRole } from ”@volcengine/ark-runtime“;const service = ArkService.builder() .apiKey(process.env.ARK_API_KEY) .build();async function callDoubao(prompt) { const messages = [ { role: ChatMessageRole.SYSTEM, content: ”你是豆包 AI 助手“ }, { role: ChatMessageRole.USER, content: prompt } ]; const req = new ChatCompletionRequest({ model: process.env.DOUBAO_EP_ID, messages, stream: false }); const resp = await service.createChatCompletion(req); return resp.choices[0].message.content;}登录后复制

• 高级功能支持：
  • 支持流式输出（stream: true）
  • 支持多轮对话（conversation_id）

三、Next.js API Route 示例

export default async function handler(req, res) { if (req.method !== ”POST“) return res.status(405).end(); const { prompt } = req.body; const messages = [ { role: ”system“, content: ”你是豆包 AI 助手“ }, { role: ”user“, content: prompt } ]; const chatReq = new ChatCompletionRequest({ model: process.env.DOUBAO_EP_ID, messages, stream: false }); const result = await service.createChatCompletion(chatReq); res.status(200).json({ text: result.choices[0].message.content });}登录后复制

四、注意事项与建议

• 建议控制 prompt 长度，避免不必要的 Token 消耗。
• 合理使用上下文，提升对话智能性与连贯性。
• 结合前端使用流式输出优化用户体验。

五、前端集成推荐方式

• 在 Next.js 中通过 API Route 包装调用逻辑。
• 结合 React 组件构建问答型助手界面。
• 可搭配 Shadcn UI 或 Radix UI 实现弹窗交互。