需先注册火山引擎账号并完成实名认证(个人1工作日、企业1–2工作日),再开通豆包大模型服务、创建并安全保存API Key,配置Go项目环境变量及SDK,最后用Endpoint ID调用验证成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

注册火山引擎账号并完成实名认证
你需要一个已通过企业或个人实名认证的火山引擎账号,这是调用豆包API的强制前提,未认证账号无法创建API密钥、开通模型服务,所有后续操作都会在控制台被拦截。
访问火山引擎官网(https://www.volcengine.com),点击右上角“注册”,用手机号或抖音扫码完成初始注册;登录后立即进入“账号中心→实名认证”,上传身份证正反面并完成人脸识别;【个人认证审核通常需1个工作日,企业认证需1–2个工作日,期间无法创建API密钥】。
开通豆包大模型服务与获取API Key
实名认证通过后,按路径进入服务管理界面:登录控制台 → 顶部导航栏“产品与服务” → “人工智能” → “火山方舟(ModelArk)” → 左侧菜单“模型服务” → 找到“Doubao-pro-32k”或“Doubao-lite-32k” → 点击“开通服务”并勾选协议。
服务开通成功后,返回左侧菜单,点击“API密钥管理” → “创建API Key” → 填写描述(如“go-prod-tts”)→ 点击“确定”;生成后立刻点击“眼睛图标”查看完整密钥,【该密钥仅在此刻可完整显示一次,关闭页面即永久不可见,务必立即复制保存】。
立即进入“豆包AI人工智官网入口”;
立即学习“豆包AI人工智能在线问答入口”;
配置Go项目依赖与环境变量
初始化Go模块:go mod init your-project-name;安装官方SDK:go get github.com/volcengine/volc-sdk-go@latest。
在项目根目录创建 .env 文件,写入:ARK_API_KEY=your_copied_api_key_here;不要将密钥硬编码进源码,避免提交至Git仓库泄露;使用 godotenv 或 os.Getenv("ARK_API_KEY") 在代码中安全读取。
若你使用 OpenAI 兼容方式调用(如集成到已有 LLM 工具链),还需额外设置 ARK_ENDPOINT_ID=ep-xxxxxxxx(从“模型推理→接入点”页面获取),否则默认请求会因 model 字段缺失而返回 400 错误。
编写Go调用代码并验证响应
新建 main.go,导入 net/http、io、os、encoding/json、github.com/volcengine/volc-sdk-go/service/ark/client、github.com/volcengine/volc-sdk-go/core。
第一步:用 client.NewClient() 初始化客户端,传入 region(固定为 cn-beijing)和 credentials.NewStaticCredentials(“”, os.Getenv(“ARK_API_KEY”), “”);第二步:构造 chat.CompletionsCreateRequest,设置 Model 字段为 Endpoint ID(非模型名),Messages 为 []map[string]string{ {“role”: “user”, “content”: “你好”} };第三步:调用 client.Chat.Completions.Create(req),检查 resp.StatusCode == 200 且 len(resp.Choices) > 0;第四步:打印 resp.Choices[0].Message.Content 确认返回文本。
运行 go run main.go,若输出“你好”或类似响应,说明鉴权与路由通路已打通;若报错 401,请回查 API Key 是否复制完整、.env 是否加载、Endpoint ID 是否填写正确。



















