必须先创建api key才能调用火山引擎大模型服务;需实名认证账号登录方舟控制台,在api key管理页创建并严格选择对应项目空间,创建后立即复制密钥并安全保存,关闭页面后不可恢复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在火山引擎上使用大模型服务(比如DeepSeek-R1、Web Search插件或深度研究Agent),必须先创建一个合法有效的API Key作为调用凭证,否则所有请求都会因鉴权失败而被拒绝。
登录火山引擎控制台
打开浏览器,访问 https://www.volcengine.com,使用已实名认证的主账号或IAM用户身份登录。未实名认证的账号无法创建API Key,【创建操作会被直接拦截】。
登录后,点击顶部导航栏「产品」→「人工智能」→「方舟大模型平台」,或直接在搜索框输入“方舟”跳转至控制台首页。
进入API Key管理页面
在方舟控制台左侧菜单中,依次点击「API管理」→「API Key管理」。注意:不同产品线(如语音SAAS、MQTT实例)也有独立的API Key入口,但大模型调用必须使用「方舟大模型平台」下的API Key。
若页面提示“暂无权限”,说明当前登录账号不是主账号,也未被授予 ark:CreateApiKey 权限,请联系企业管理员分配对应IAM策略。
创建API Key
方法一:控制台图形界面创建
第一步:点击页面左上角「创建API Key」按钮。
第二步:在弹出表单中填写名称,规则为:1–100字符,中文/字母/数字开头,仅允许“-”和“_”,不能含空格或特殊符号(如@、#、$)。
第三步:确认项目空间——【务必选择你实际部署模型服务的项目,API Key仅对该项目内资源生效】。若账号下有多个项目,切换错误会导致后续调用返回403 Forbidden。
第四步:点击「创建」,系统生成API Key并自动隐藏密钥值。此时列表中会出现新条目,状态为“启用”。
方法二:通过API接口创建(适用于自动化脚本)
调用 CreateAPIKey 接口,需携带以下必填参数:Action=CreateAPIKey、Version=2025-05-20、ProjectName=your_project_name、Name=your_key_name。签名必须使用当前账号的Access Key Secret生成,否则返回InvalidParameter错误。
获取并保存API Key值
在API Key列表页,找到刚创建的条目,点击右侧 ?️ 图标展开密钥明文。此时才真正生成可使用的密钥字符串。
点击「复制」按钮一键复制,立即将其粘贴到安全位置(如密码管理器或加密文本文件)。【关闭该页面后密钥值将永久不可见,也无法再次查看或重置】。
复制完成后,建议立即配置为环境变量(如VOLC_ACCESSKEY),避免硬编码进代码或配置文件中。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











