二级指引 · 主教程第 0 步展开
火山方舟 ARK:开通豆包模型
系统用豆包模型做选题分析、口播稿生成和关键词梳理。这一步是安装前唯一需要你亲自操作的技术环节。
为什么单独开一页? 火山方舟和别的 AI 平台不一样:注册完不会给你一个能调所有模型的万能 Key,你必须先建「推理接入点」才能拿到模型 ID。很多学员就是卡在这里,所以单独拆成详细指引。全程约 15 分钟。
1
API Key
ark- 或一串密钥
调用凭证。相当于密码,只显示一次。
2
推理接入点 ID
ep-2025xxxx-xxxxx
就是系统里的 ARK_MODEL。ep- 开头,不是模型名。
3
接入地址
固定值,可直接复制
下面提供,不用自己找。
最容易出错的一点
很多人把模型名(如 doubao-seed-2-1-pro)当成模型 ID 填进去,结果调用直接报错。要填的是接入点 ID,就是你建完接入点后系统生成的那串 ep- 开头字符。
本页步骤
- 注册火山引擎账号
- 完成实名认证(没有这步选不了模型)
- 创建推理接入点,拿到 ep- 开头的 ID
- 创建 API Key 并当场保存
- 把 3 个值回填给安装助手
- 验证是否成功
① 注册账号
- 目标
- 拥有一个能登录火山方舟控制台的账号。
- 操作
- 打开火山方舟官网,点右上角「注册 / 立即注册」,用手机号接收验证码完成注册。
- 完成标志
- 登录后能看到火山方舟控制台首页。
https://console.volcengine.com/ark
个人还是企业?
学员自用选个人即可,实名快、门槛低。要给公司开票或多人协同时才需要企业主体。
② 实名认证
- 目标
- 拿到选购和开通模型的资格。
- 操作
-
控制台右上角头像 › 账号中心 › 实名认证
选择个人认证,填写姓名 + 身份证号,按提示完成人脸识别。
- 完成标志
- 实名认证状态显示为「已认证」。
这一步跳不过去
没完成实名,模型列表是空的,也点不动「开通」按钮。如果你在第 3 步发现选不了模型,回来检查这里。认证通常几分钟内通过,高峰期可能稍慢。
③ 建接入点,拿到 ep- 开头的 ID
- 目标
- 获得一个专属的模型 ID(形如
ep-20250512-xxxxx),这就是系统要的 ARK_MODEL。
- 操作
-
方舟控制台 › 在线推理 › 创建推理接入点
① 接入点名称:随便起,建议写「选题追踪-主模型」方便以后认;
② 推理模式:选「单一模型」;
③ 点击「添加模型」,在模型列表里选豆包系列(如 Doubao-Seed 系列,具体版本以控制台当下可选为准);
④ 选好版本后点「创建并接入」。
- 完成标志
- 接入点列表里出现一条记录,ID 是
ep- 开头的一串字符。
为什么要多这一步?
接入点相当于给「某一个模型的调用」开了独立面板:限流、监控、账单都能单独看,不会把所有模型混成一笔糊涂账。建议主力模型和音频模型分开建两个接入点,将来查用量、查报错都好定位。
拿到后立刻记下来
把 ep- 开头的这串 ID 保存到密码管理器里。下一步的 Key 和这个 ID 是配套使用的。
④ 创建密钥
- 目标
- 拿到调用模型的凭证字符串。
- 操作
-
方舟控制台 › API Key 管理 › 创建 API Key
给它起个名字(如「选题追踪」),确认创建,然后立刻复制保存。
- 完成标志
- 拿到一串密钥字符,已存到密码管理器。
密钥只显示这一次
关掉弹窗后就再也看不到明文,只能删掉重建。别只瞄一眼,当场存好。
安全建议
主账号的密钥权限很大。如果你的场景只是调用推理接口,官方建议单独建一个 IAM 子账号来管这类 Key,别把主账号权限最大的凭证到处塞进脚本里。
⑤ 把 3 个值交给 AI
- 目标
- 让安装助手把配置写进你的系统。
- 操作
- 回到主教程的对话窗口,把下面这段填好发给 AI(把尖括号里的内容换成你自己的)。
- 完成标志
- AI 回复配置已写入,并进入下一步安装。
可复制这段,填好后发给 AI:
火山方舟配置好了:
ARK_API_KEY = 你的API Key
ARK_MODEL = 你的推理接入点ID(ep- 开头那串)
ARK_BASE_URL = https://ark.cn-beijing.volces.com/api/v3
接入地址是固定的
https://ark.cn-beijing.volces.com/api/v3 是火山方舟的通用接入地址,一般不用改。除非你用了其他地域,才需要换成控制台里显示的地址。
⑥ 试跑确认
- 目标
- 确认豆包模型真的能被调用,而不是配了个寂寞。
- 操作
- 安装助手会跑一次测试。你也可以直接问 AI:「测一下火山方舟能不能通」。
- 完成标志
- AI 返回模型调用成功,或跑出了一条真实的选题分析。
配错了会怎样
如果 Key 或接入点 ID 填错,系统不会崩溃,而是自动降级成规则引擎(只用关键词和点赞数排序,不做 AI 分析)。表面看还有选题出来,但质量差一截。所以这一步一定要验证。
| 现象 | 原因 | 怎么办 |
| 模型列表是空的 / 点不动开通 | 没完成实名认证 | 回到第 2 步做实名 |
| 调用报模型不存在 | 填了模型名而不是接入点 ID | 换成 ep- 开头的 ID |
| Key 忘了、找不回明文 | 创建时没保存 | 删掉重建一个 |
| 有选题但明显没经过 AI 分析 | Key 无效,已降级为规则引擎 | 重做第 6 步验证 |
| 突然开始报错额度不足 | 额度不足或计费状态异常 | 控制台「资源包」查余额,设余额提醒 |