火山引擎怎么通过API调用豆包_火山引擎豆包接口接入教程-人工智能-PHP中文网

必须完成实名认证并创建api key与推理接入点，否则请求将返回401或404错误；实名认证30秒内自动通过，api key仅显示一次须立即保存，endpoint id在接入点状态变为“运行中”后于详情页获取。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

火山引擎怎么通过api调用豆包_火山引擎豆包接口接入教程

要在项目中通过代码调用豆包大模型的推理能力，必须从火山引擎获取合法凭证和可用端点，缺一不可。不完成实名认证就无法创建API Key，不创建推理接入点就无法获得Endpoint ID，这两项缺失会导致所有HTTP请求直接返回401或404错误。

完成火山引擎账号注册与实名认证

打开浏览器访问 https://www.volcengine.com，点击右上角“注册”，用手机号+验证码完成新账号创建。已有抖音或今日头条账号可直接快捷登录。

登录后进入右上角「账号管理」→「实名认证」，选择“个人”类型，按提示上传身份证正反面照片。系统自动OCR识别，通常30秒内审核通过。这一步【不完成则后续所有API操作均被拒绝】。

进入火山方舟平台并创建API Key

在控制台顶部搜索框输入“火山方舟”，或直接访问 https://console.volcengine.com/ark 进入平台首页。

左侧导航栏点击「API 密钥管理」→「创建API Key」，填写名称如“doubao-prod-key”，点击确定。页面立即弹出密钥字符串，形如 ek-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。

这个密钥【只显示一次，关闭页面即永久丢失】，必须立刻复制并保存到安全位置（如密码管理器），不可截图存桌面——截图可能被同步到云端泄露。

开通豆包模型并创建推理接入点

第一步：进入「模型管理中心」→「豆包系列」，勾选开通 Doubao-lite-128k（轻量免费）或 Doubao-pro-256k（效果更强），点击「开通」。

第二步：左侧菜单进入「在线推理」→「创建推理接入点」。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

下载

第三步：填写名称（如“doubao-chat”）、选择已开通的豆包模型、地区选 cn-beijing，点击「创建」。

等待状态由“创建中”变为“运行中”，耗时约20～60秒。此时点击该接入点右侧「详情」，在「基本信息」区域复制 Endpoint ID，格式为 ep-xxxxxxxxxxxxxxxxxxxxxxxx。

构造HTTP请求调用豆包模型

方法一：使用curl命令快速验证

在终端执行以下命令（将YOUR_API_KEY和YOUR_ENDPOINT_ID替换成实际值）：

curl -X POST "https://ark.cn-beijing.volces.com/api/v3/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_ENDPOINT_ID",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

方法二：前端JavaScript中调用（需代理避免跨域）

fetch("https://your-proxy-domain.com/api/doubao", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    api_key: "YOUR_API_KEY",
    endpoint_id: "YOUR_ENDPOINT_ID",
    prompt: "请用一句话介绍自己"
  })
})

注意：前端直连火山引擎域名会触发CORS拦截，必须通过自建代理或火山引擎提供的网关服务转发请求。