如何接入豆包大模型，豆包都有哪些API

一秒公司

1852人浏览 · 2026-06-13 16:46:12

一秒公司 · 2026-06-13 16:46:12 发布

豆包系列模型简介（2026年6月）

豆包大模型在火山引擎的 “火山方舟” 平台上以 API 形式提供。目前主要分为这些系列：

模型系列	代表型号	上下文长度	特点与适用场景
豆包 Pro（旗舰）	Doubao-1.5-pro-256k Doubao-1.5-pro-32k	256k / 32k	逻辑推理、复杂指令遵循、长文理解最强；适合金融分析、合同审核、深度问答。
豆包 Lite（轻量）	Doubao-1.5-lite-32k Doubao-1.5-lite-128k	32k / 128k	成本极低、响应快；适合客服、内容摘要、简单对话等高并发场景。
豆包视觉（多模态）	Doubao-1.5-vision-32k	32k	支持图片输入，能理解图表、照片、文档扫描件；适合OCR信息提取、图片问答。
豆包 Embedding	Doubao-embedding-large	-	文本向量化，用于语义搜索、RAG知识库检索。
豆包语音	Doubao-speech-tts / asr	-	语音合成与识别，直接生成自然语音或转写文字。
豆包角色扮演	Doubao-1.5-character-32k	32k	专门为角色对话、虚拟人、游戏NPC调优，人设保持更稳定。

此外，平台还提供Function Call 优化版、代码生成版等垂类模型，都可以在控制台查看最新列表。对于绝大多数企业文本生成需求，Doubao-1.5-pro-256k 是首选主力。

二、接入豆包 API 详细教程

准备工作

火山引擎账号：前往 volcano engine官网注册（通过手机号或微信），完成企业或个人实名认证。
确认服务区域：豆包 API 全链路均部署在中国大陆，天然符合数据出境合规要求，无需额外审批。
开发环境：支持 Python、Java、Go 等语言。教程以 Python 为例。

第一步：开通“火山方舟”并创建推理接入点

登录火山引擎控制台，进入 “火山方舟” 产品页。
点击 “立即开通”，同意协议后，服务即被激活（按量计费，无需预付）。
在方舟左侧菜单选择 “推理接入点”（或叫“模型推理”），点击 “创建接入点”。
填写配置：
- 接入点名称：如 my-pro-256k
- 选择模型：下拉列表会显示所有可用模型，如 Doubao-1.5-pro-256k
- 上下文长度：通常自动匹配模型默认值，可调。
- 速率限制：根据需要设定每分钟/每天请求上限（避免意外超支）。
点击确定，系统会为这个接入点生成唯一的 Endpoint ID（形如 ep-202606xxxxxxxx）和 API Key。

关键概念：豆包 API 使用 “接入点（Endpoint）” 来隔离不同业务、不同模型。同一个模型可以建多个接入点，分别监控成本与性能。

第二步：获取 API Key 与 Endpoint ID

创建完成后，在推理接入点列表中，点击刚建好的接入点名称，进入详情页：

Endpoint ID：显示在基本信息区。
API Key：需要点击「显示」并复制。建议立即保存到密码管理器，离开页面后可能无法再次查看明文。

第三步：调用 API（兼容 OpenAI SDK）

豆包 API 设计完全兼容 OpenAI SDK 接口，你只需修改 base_url 和 api_key 即可用你熟悉的代码接入。

Python 示例（使用 openai 库）：

python

import openai

# 豆包 API 配置
client = openai.OpenAI(
    api_key="你的API Key",  # 从控制台复制的key
    base_url="https://ark.cn-beijing.volces.com/api/v3",  # 固定地址
)

# 调用示例
response = client.chat.completions.create(
    model="ep-202606xxxxxx-xxxxx",  # 这里填你的 Endpoint ID，而非模型名
    messages=[
        {"role": "system", "content": "你是一个专业的技术顾问。"},
        {"role": "user", "content": "解释一下云原生架构的优势。"}
    ],
    temperature=0.7,
    max_tokens=1024,
)

print(response.choices[0].message.content)

注意：

model 参数必须填 接入点 ID，不能直接填模型名（如 Doubao-1.5-pro-256k），这是豆包不同于官方 OpenAI 的地方。
base_url 使用 https://ark.cn-beijing.volces.com/api/v3，这是国内公共 endpoint。如有专属通道，会单独提供。