豆包(火山引擎):API Key 怎么拿、怎么接进手机写小说

字节生态全家桶:豆包 Seed 文本视觉之外,Seedream 生图和 Seedance 生视频都是国产第一梯队,大陆家里模态覆盖仅次于阿里百炼(只差 TTS)——给角色画立绘、给章节配视频可以只养这一把 Key。 本页是 豆包(火山引擎) 的 BYOK 接入直答:取 Key 分步、控制台与定价页直链、接进 Foreverse 的注意事项。核实于 2026-07-18。

两个入口先放这:取 Key 去 官方控制台,价格查 官方定价页。价格与免费额度随时会调,以官方页面实时为准。

在 Foreverse 里能用它做什么?

预置模板给 豆包(火山引擎) 声明了 5 个模态位。实际可用模型以 App 内拉取的该家模型目录为准——各家上新很快,模板标记只代表接入协议已就绪。

模态在 App 里对应
文本续写 · 角色聊天 · Agent
视觉看图对话(发照片给角色)
生图选区配图 · 时刻卡 · 漫画册
视频选区配视频
向量世界书向量检索

豆包(火山引擎) 的 API Key 怎么拿?

  1. 注册火山引擎 volcengine.com 并完成实名认证(个人身份证或企业执照)——不实名用不了方舟。
  2. 控制台顶部搜索「火山方舟」进入方舟控制台,在「开通管理」页查看/开通要用的模型——每款模型都带免费推理额度,用完要继续就在这页开通付费。
  3. 左侧「API Key 管理」→ 创建 API Key,复制 sk- 开头的 Key——只完整显示一次,当场保存。
  4. 普通按量调用到这就够了(model 直接填模型 ID);需要独立限流、预付费资源或调用精调模型时,才去「在线推理」页创建推理接入点拿 ep- ID。

拿到 Key 之后:接进 Foreverse 三步

  1. 打开 App 的设置 → AI 模型与服务,列表里找到 豆包(火山引擎)(62 家预置之一,带 logo 可搜索)。
  2. 粘贴 Key,点「测连通」——发一次真实请求验证密钥与网络,顺手拉回这家的模型列表。
  3. 启用要用的模型,在「默认模型」里按模态分别指定(文本/生图/朗读/视频各设各的);之后续写、聊天、听书就都走这家了。

改 API 地址时的通用坑:地址必须带完整版本前缀(这家该是什么样,下面注意事项里写了),App 不会替你补 /v1。

豆包(火山引擎) 专属注意

App 预置 https://ark.cn-beijing.volces.com/api/v3——版本前缀是 /api/v3 不是 /v1,自定义填 host 照抄完整路径(北京区;其它区域要把域名里的区域段一起换)。火山特有坑:老教程都说 model 必须填 ep- 开头的推理接入点 ID——现在 API Key 鉴权下直接填模型 ID(形如 doubao-seed-2-0-pro-260215,版本日期尾缀是 ID 的一部分)即可调用,前提是模型已在开通管理里开通;ep- 接入点 ID 仍然兼容。Seedream 生图与 Seedance 视频走火山原生端点,App 已适配,同一把 Key。

常见问题

豆包(火山引擎) 有免费额度吗?

有:豆包系模型每款都带免费推理额度(长期口径 50 万 tokens/模型),未开通付费的新用户默认处于「安心体验模式」——只消耗赠送额度、快用完自动暂停服务,不会意外扣费。额度只抵扣模型推理 tokens(插件、知识库不算),余量以控制台开通管理页为准。

填进 App 的 Key 存在哪里?

系统级加密后只存在你的手机本机,不上传、不同步到 Foreverse 任何服务器;请求从手机直连供应商官方端点,我们不经手也不加价。想撤销就去供应商控制台吊销那把 Key。

豆包(火山引擎) API Key 怎么拿?取 Key 到手机接入全流程(BYOK) · Foreverse · 新梦