先完成火山引擎账号注册与实名认证,再开通火山方舟大模型服务,接着创建api凭证获取access key、secret key及模型endpoint、model id,最后安装sdk并运行python代码调用api。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想在自己的项目里调用火山引擎的AI能力,但卡在第一步——连账号怎么注册、API Key在哪找、模型ID怎么生成都搞不清。别翻文档了,这篇教程直接带你从零开始,每一步都对应控制台真实界面,做完就能跑通第一个API请求。
注册账号并完成实名认证
打开火山引擎官网(https://www.volcengine.com/),点击右上角「注册」,用手机号或邮箱完成基础注册。
注册后立即进入「账号管理」→「实名认证」页面,个人用户上传身份证正反面照片,企业用户需提交营业执照;【未完成实名认证,后续所有模型服务均无法开通】。
认证提交后等待1–2个工作日审核,期间可先熟悉控制台布局。
开通方舟大模型平台并选择模型
登录控制台,顶部导航栏点击「大模型」→「火山方舟」,进入模型广场。
在搜索框输入你想要的模型名称,例如“Doubao-Seed-2.0-pro”或“GLM-5.2”,找到对应卡片后点击「开通」。
阅读服务协议并勾选同意,点击确认——开通成功后,该模型会出现在「已开通模型」列表中,状态显示为“运行中”。
创建API凭证并获取关键参数
点击左侧菜单「API 调用」→「凭证管理」→「创建凭证」。
填写凭证名称(如“dev-test-key”),权限范围选择「方舟大模型」,点击「确定」。
系统自动生成 Access Key 和 Secret Key;【Secret Key 仅显示一次,关闭页面即不可找回,务必立即复制保存】。
返回「在线推理」→「自定义推理接入点」,找到你刚开通的模型,点击「创建推理接入点」→「开通模型并接入」。完成后,在接入点详情页复制以下三项:
- Endpoint:形如 https://ark.cn-beijing.volces.com/api/v3
- Model ID:形如 ep-2025xxxxxx(不是模型名,是专属部署ID)
- API Key:即刚才创建的 Access Key
安装SDK并运行第一个Python请求
确保已安装 Python 3.10 或更高版本,命令行执行:
pip install volcengine-python-sdk[ark] -U -i https://mirrors.aliyun.com/pypi/simple/
新建 test.py 文件,粘贴以下代码(替换三处占位符):
import os
from volcenginesdkarkruntime import Ark
client = Ark(
base_url="https://ark.cn-beijing.volces.com/api/v3",
api_key="your_access_key_here"
)
response = client.responses.create(
model="ep-2025xxxxxx",
input="你好,请用一句话介绍你自己"
)
print(response.output.text)
保存后在终端运行 python test.py,看到返回的文本即表示调用成功。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











