调用火山引擎豆包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，必须绕过“直接填模型名”的思维陷阱——【model参数必须传入Endpoint ID，不是模型名称】，否则返回404或invalid_model错误。

获取凭证与接入点

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

注意：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。