豆包 API 怎么接入？2026年保姆级教程

准备工作：注册与实名认证

接入豆包 API 首先需要访问火山引擎官网，注册账号并完成实名认证。这是使用豆包大模型服务的前提条件。完成认证后，你就可以开始创建 API Key 和推理接入点了。

创建推理接入点

在火山引擎控制台，点击'创建推理接入点'，选择你需要的模型版本，如 doubao-lite-128k 或 doubao-pro-128k。创建成功后，系统会生成一个 Endpoint ID（格式为 ep-开头），这个 ID 是后续调用 API 时必须使用的模型名称。记住这个 ID，它是连接你的应用和豆包模型的关键。

获取 API Key

进入 API Key 管理页面，点击'创建 API Key'，输入名称后即可生成。注意 API Key 的有效期设置，建议根据项目需求合理配置。对于测试环境，可以设置较长的有效期以减少频繁更新。如果你也在评估豆包之外的模型，可以打开不墨 Router，查看可接入的模型。截至 2026-10-24，Router 公开模型列表没有豆包；它可用于比较已上架的 DeepSeek、Kimi、千问等模型，不能替代本文的豆包官方接入。Router 使用自己的 Key、https://router.bumo.cc/v1 和带厂商前缀的完整模型 ID；不要把火山引擎的 Key 或 ep- 接入点直接填进去。

API 调用示例

豆包 API 兼容 OpenAI SDK 标准接口，API 路径为 /api/v3/chat/completions，域名为 https://ark.cn-beijing.volces.com。调用时将 model 参数设置为你的 Endpoint ID 即可。Python 示例代码如下：

import openai
openai.api_base = 'https://ark.cn-beijing.volces.com/api/v3'
openai.api_key = '你的API Key'
response = openai.ChatCompletion.create(
    model='ep-你的EndpointID',
    messages=[{'role': 'user', 'content': '你好'}]
)

如果你需要更简单的调用方式，bumo 支持直接在网页端测试豆包模型，无需编写代码。

常见问题

很多开发者会问：为什么需要创建接入点？这是因为豆包采用云原生架构，接入点相当于为你分配专属的推理资源。另外，豆包模型名称就是接入点名称，这点在调用时容易混淆，请务必注意。通过本教程，你应该已经掌握了豆包 API 的完整接入流程，快去试试吧！