OpenAI SDK兼容调用火山引擎豆包API步骤

在调用火山引擎豆包API时，需将Endpoint ID作为model参数，而非模型名，否则会出现404或invalid_model错误。您需要在火山方舟创建推理接入点，以获取ARK_API_KEY和以ep-开头的Endpoint ID，并通过.env文件进行安全配置。在代码中，使用base_url="https://ark.cn-beijing.volces.com/api/v3"和OpenAI SDK进行调用。

用Python通过OpenAI SDK调用火山引擎豆包API，必须绕过“直接填模型名”的思维陷阱——

，否则返回404或invalid_model错误。

获取凭证与接入点

登录火山引擎控制台 → 进入「火山方舟」→ 在「模型广场」搜索并开通 Doubao-lite-32k（免费额度充足，响应快） → 点击该模型右侧「创建推理接入点」→ 填写名称（如doubao-lite-for-openai），选择地域（推荐cn-beijing）→ 创建成功后立即复制保存两样东西：

和 。

注意：API Key只显示一次，丢失需重新生成；Endpoint ID是调用时model字段的唯一合法值，不是doubao-lite-32k也不是doubao-pro。

配置运行环境

确保已安装 Python 3.8+，然后执行：

pip install openai>=1.30.0 python-dotenv>=1.0.1

新建.env文件，写入：

ARK_API_KEY=apikey-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
DOUBAO_ENDPOINT_ID=ep-20260806111300-abcde

这一步不可跳过——硬编码密钥会导致Git泄露、多人协作混乱、上线后被扫库盗用。

编写并运行调用代码

新建doubao_call.py，内容如下：

import os
from openai import OpenAI
from dotenv import load_dotenv

# 加载环境变量文件
load_dotenv()

# 创建OpenAI客户端实例
client = OpenAI(
    # 设置API基础地址
    base_url="https://ark.cn-beijing.volces.com/api/v3",
    # 设置API密钥
    api_key=os.getenv("ARK_API_KEY")
)

# 使用Chat Completions API创建对话完成
response = client.chat.completions.create(
    # 设置模型为环境变量中指定的端点ID
    model=os.getenv("DOUBAO_ENDPOINT_ID"),
    # 设置对话消息列表，包含系统消息和用户消息
    messages=[
        {"role": "system", "content": "你是一个简洁准确的中文助手"},
        {"role": "user", "content": "列出三个Python常用虚拟环境工具"}
    ],
    # 设置温度参数，控制生成文本的随机性
    temperature=0.3
)

# 打印对话完成的响应内容
print(response.choices[0].message.content)

关键点：base_url必须是https://ark.cn-beijing.volces.com/api/v3，其他域名已停用；model字段必须是os.getenv("DOUBAO_ENDPOINT_ID")，不能写死字符串；temperature等参数可按需调整，豆包对0.1~0.7区间响应最稳定。

在终端中执行：python doubao_call.py。