火山引擎DeepSeek API接入教程-人工智能-PHP中文网

必须先获取api key、bot id和接入域名三要素，缺一不可；注册火山引擎账号并完成实名认证后开通模型服务，再创建推理接入点并关联应用生成不可修改的bot id，最后在账号管理中创建api key、确认正确调用域名（如ark.cn-beijing.volces.com），方可调用deepseek-r1或v4-flash模型。

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

火山引擎deepseek api接入教程 - php中文网

要在火山引擎上用上DeepSeek-R1或V3/V4-Flash这些满血模型，必须先拿到API Key、Bot ID和接入域名——三者缺一不可，漏掉任何一个，后续调用都会返回401或404错误。

注册账号并完成实名认证

打开火山引擎官网（https://www.volcengine.com），点击右上角【立即注册】，支持手机号或邮箱注册。注册成功后，【必须完成实名认证】，否则无法开通模型服务。个人认证用微信或抖音App扫脸，企业认证需上传营业执照。未实名的账号在“模型推理”页面会看到灰色禁用状态，点不开任何模型。

实名完成后，进入控制台→点击顶部导航栏【模型推理】→找到DeepSeek-R1或DeepSeek-V3/V4-Flash，点击【立即开通】。勾选全部协议，提交即可。系统会自动为你分配初始额度（R1默认50万Token，V4-Flash首月赠100万Token）。

创建推理接入点并获取Bot ID

第一步：在【模型推理】→【在线推理】页面，点击【创建推理接入点】。

第二步：模型选择DeepSeek-R1（或V3/V4-Flash），名称填“R1-prod”“V4-flash-test”这类可识别的标识，点击【确认创建】。

第三步：创建成功后，页面自动跳转至该接入点详情页→左侧菜单点【关联应用】→【立即创建】→填写Bot ID（如“ds-r1-search”），【Bot ID一旦生成不可修改】，建议带环境和用途前缀，避免后期混淆。

第四步：创建Bot后，开启【联网内容插件】→点击右上角【发布】。发布成功后，页面右侧会出现Bot ID字段，点击复制并保存——这个ID将在HTTP请求Header中作为X-Bot-ID使用。

获取API Key与调用域名

方法一：API Key直接获取

php获得文件的mime type类

下载

进入【账号管理】→【API密钥】→【创建API密钥】，填写描述如“火山R1生产调用”，点击创建。密钥生成后【仅显示一次】，必须立即复制保存，丢失无法找回。

方法二：调用域名确认

在刚创建的接入点详情页，向下滚动到【API调用】区域，找到“请求地址”一行。V4-Flash和R1共用同一域名格式：https://ark.cn-beijing.volces.com/api/v1（北京地域），若你开通的是上海/广州节点，域名后缀分别为cn-shanghai.volces.com或cn-guangzhou.volces.com。不要用官方文档里写的旧域名api.volcengine.com，那个已停用。

注意：V4-Flash正式版（模型名deepseek-v4-flash）和R1（模型名deepseek-r1）的base_url完全一致，仅model参数不同。

Python调用示例（含联网搜索）

安装依赖：pip install requests

以下代码调用DeepSeek-R1并启用联网搜索：

```python
import requests

url = "https://ark.cn-beijing.volces.com/api/v1/chat/completions"
headers = {
  "Authorization": "Bearer sk-xxx",
  "Content-Type": "application/json",
  "X-Bot-ID": "ds-r1-search"
}
data = {
  "model": "deepseek-r1",
  "messages": [{"role": "user", "content": "2026年8月中国新能源汽车销量TOP5品牌"}],
  "enable_search": True
}

resp = requests.post(url, headers=headers, json=data)
print(resp.json()["choices"][0]["message"]["content"])
```