必须完成模型开通与接入点绑定两步操作:先实名认证后在模型广场开通目标模型,再创建推理接入点并绑定已开通模型id,最后配置api key、access key、secret key及ep-开头的session_token方可调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在火山引擎上让API Key具备调用特定大模型(如豆包Doubao、DeepSeek等)的权限,必须完成模型开通与接入点绑定两步操作——只创建API Key但未开通模型,调用时会返回403 Forbidden或model not found错误。
开通目标模型服务
登录火山引擎控制台 → 进入「方舟大模型平台」→ 点击左侧菜单「模型广场」→ 在搜索框输入模型名称(例如 doubao-pro-32k-241215 或 deepseek-v3.2)→ 找到对应模型卡片 → 点击「开通」按钮。
【必须实名认证后才能开通】新账号首次使用需微信扫码完成人脸识别实名认证,否则“开通”按钮为灰色不可点击状态。
开通成功后,该模型会出现在「已开通模型」列表中,此时仅表示你拥有调用资格,尚未生成可直接使用的接入地址。
创建推理接入点并绑定模型
进入「推理接入点」管理页(路径:方舟大模型平台 → 左侧导航栏 → 推理接入点)→ 点击「创建推理接入点」。
填写接入点信息:
• 名称:自定义,建议含模型缩写(如 doubao-pro-32k)
• 描述:可选填
• 模型选择:从下拉菜单中严格选择你已开通的模型ID(注意不是模型名称,是控制台显示的 model_id 字段值)
• 接入点类型:选 public(公网访问)
点击「确定」后,系统生成一个以 ep- 开头的唯一接入点ID(如 ep-20260804abcd1234),这个ID将作为后续请求中的 session_token 或 endpoint_id 使用。
这一步不可跳过。即使API Key有效、模型已开通,若未创建接入点,所有请求都会被拒绝——火山引擎不支持直接通过 model_id 调用,必须经由接入点路由。
配置环境变量或代码参数
方法一:设置系统环境变量(推荐用于本地开发或CLI工具)
• VOLCENGINE_ACCESS_KEY → 值为你在「API密钥管理」页复制的 Access Key ID
• VOLCENGINE_SECRET_KEY → 值为对应的 Secret Access Key
• VOLCENGINE_SESSION_TOKEN → 值为上一步生成的 ep- 开头的接入点ID
• ARK_API_KEY → 值为你在「API密钥管理」页创建的 API Key(注意:不是Access Key!)
方法二:在代码中显式传参(适用于Python SDK)
初始化客户端时,必须同时提供:
– access_key 和 secret_key(用于签名鉴权)
– session_token(即接入点ID,用于指定路由目标)
– model_id(必须与接入点创建时选择的模型ID完全一致)
若漏填 session_token,SDK 会默认使用空字符串,导致请求被分配到无效路由,返回 InvalidEndpoint 错误。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











