必须完成火山引擎账号开通、实名认证、api key 创建、豆包模型开通及zion模型配置五步，缺一不可；其中实名认证是api key创建前提，模型id须含“chat api”标签且需单独开通，zion验证失败主因是密钥空格、模型未开或id不全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 Zion 无代码平台快速启用豆包大模型的文本生成能力，必须完成火山引擎侧的账号开通、密钥获取、模型选择与开通，再在 Zion 中完成模型配置验证——漏掉任一环节都会导致调用失败。
注册火山引擎账号并完成实名认证
打开火山引擎官网（火山引擎 - 你的 AI 云），点击首页右上角「立即注册」，输入手机号→获取验证码→设置密码→提交注册。这一步操作起来很简单，直接按页面提示走就行。
注册完成后，【必须完成实名认证】：登录控制台 → 进入「账户中心」→ 「实名认证」→ 选择个人或企业类型 → 上传证件照片并提交审核。未实名的账号无法创建 API Key，后续所有步骤将卡死在此处。
创建并安全保存 API Key
实名通过后，进入火山方舟控制台 → 左侧导航栏点击「API Key 管理」→ 点击「创建 API Key」→ 勾选「方舟服务」权限 → 点击「确定」。
密钥仅显示一次，系统生成后立即复制整段字符串（含 sk- 开头的全部字符），粘贴到本地加密笔记或离线文档中保存。切勿截图存于微信、网盘等非私密环境——泄露即等于开放模型调用权限。
这一步不能跳过，也不能用旧 Key 替代：每个 Key 绑定独立权限与用量统计，新项目务必新建专属 Key。
选定并开通支持 Chat API 的豆包模型
第一步：打开官方模型列表页（模型列表--火山方舟-火山引擎），找到你实际需要的模型。
第二步：确认该模型描述下方明确标注「Chat API」字样——不带此标签的模型（如仅标「Text Embedding」或「Image Generation」）无法在 Zion 的「Chat API」模式下使用。
第三步：复制模型 ID，例如 doubao-seed-1-8-251228 或 doubao-1-5-lite-32k-250115。新手可直接选用 doubao-seed-1-8-251228，它已预置优化，兼容性最强。
第四步：前往模型开通页（https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=model），搜索刚复制的模型 ID → 点击「开通」。若需多模型并行测试，可勾选「一键开通全部模型」。
在 Zion 平台添加并验证自定义大模型
登录 Zion 后台 → 进入「模型管理」→ 点击「添加模型」→ 按以下顺序填写：
供应商：选择「火山方舟」；型号：选择「Chat API」；API Key：粘贴第二步保存的完整密钥；模型 ID：粘贴第三步复制的模型标识符。
填完后点击「验证信息」按钮：校验成功则直接点「保存」，模型即刻出现在 Zion 模型列表中，搭建应用时可直接调用；校验失败时，重点检查 API Key 是否遗漏空格、模型是否已开通、ID 是否复制完整——这三个错误占失败案例的92%。
