必须先完成实名认证并获取合法API密钥才能调用火山引擎AI服务,否则返回401错误;个人或企业均需上传身份证或营业执照,审核约2小时;密钥创建分IAM方式(生成Access Key ID+Secret Key,仅显示一次)和方舟控制台方式(生成Bearer格式sk-xxx,仅限AI服务);调用前须开通对应服务、获取模型ID及正确接口地址,并按规范配置请求头。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在项目中调用火山引擎的各类AI服务(如豆包大模型、即梦视频生成、语音合成等),必须先开通API并获取合法密钥,否则所有请求都会返回401错误。
完成实名认证
登录火山引擎控制台(https://console.volcengine.com/iam/keymanage/)后,若未实名,页面会强制跳转至认证入口;个人与企业均需完成认证,否则无法创建API密钥。
点击「前往实名认证」→ 选择身份证或营业执照 → 按提示上传材料并提交 → 审核通常在2小时内完成,失败时系统会明确提示缺项。
【未实名将卡死在下一步,且无法跳过】
立即进入“豆包AI人工智官网入口”;
立即学习“豆包AI人工智能在线问答入口”;
创建并保存API密钥
方法一:通过IAM访问密钥页创建
认证通过后,鼠标悬停右上角头像 → 点击「API访问密钥」→ 进入页面后点击「新建密钥」→ 勾选「仅用于API调用(推荐)」→ 点击「确定」。
密钥以Access Key ID和Secret Key形式成对出现,仅显示一次;关闭页面即永久不可见,必须立即复制到本地安全位置(如密码管理器),切勿截图存于微信或桌面。
方法二:通过火山方舟控制台快捷创建(适用于豆包类AI服务)
访问 https://ark.cn-beijing.volces.com/ → 登录后进入「API Key 管理」→ 点击「创建 API Key」→ 系统自动生成Bearer格式密钥(如sk-xxx),该密钥可直接用于OpenAI兼容接口。
注意:方舟生成的密钥不带Secret Key,仅适用于支持Bearer鉴权的AI服务;若调用ECS、RDS等云产品,则必须用IAM方式创建完整密钥对。
配置服务权限与模型接入
第一步:确认已开通对应服务
例如调用豆包大模型,需在火山方舟控制台「服务开通」中启用「豆包大模型」;调用即梦AI视频生成,需单独开通「即梦 AI-视频生成」服务,未开通则报错“ServiceNotEnabled”。
第二步:获取模型ID与接口地址
在对应服务的文档页或控制台「模型广场」中查找模型标识符,如doubao-pro-32k、jimeng-video-2.5;接口地址因区域和服务不同而异,通用格式为:https://ark.cn-beijing.volces.com/api/v1/chat/completions(豆包)、https://open.volcengineapi.com/(云产品)。
第三步:构造请求头与参数
使用Bearer密钥时,Header中必须包含:Authorization: Bearer sk-xxx;使用IAM密钥时,需按VolcEngine签名算法生成X-Date、Authorization等字段,不可直接拼接Access Key。


















