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

调用火山引擎豆包API时，需注意model参数要使用Endpoint ID，而非模型名，不然会报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()

client = OpenAI(
  base_url="https://ark.cn-beijing.volces.com/api/v3",
  api_key=os.getenv("ARK_API_KEY")
)

response = client.chat.completions.create(
  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。