火山引擎sdk需按服务类型选用对应版本：node.js用于日志服务、小程序sdk用于前端播放器、go用于视频点播、python用于机器学习平台、精调sdk用于大模型sft/dpo；选错类型将导致后续全部失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
火山引擎SDK使用需先明确目标服务类型，不同产品线SDK接入路径差异显著，不能混用同一套初始化逻辑或配置方式。
确认要使用的具体SDK类型
火山引擎提供多类SDK：Node.js SDK用于调用日志服务等后端API；微信/抖音小程序SDK用于前端播放器集成；Go SDK用于视频点播服务端开发；Python SDK用于机器学习平台工作流管理；精调SDK专用于大模型SFT/DPO任务创建。选错类型会导致后续全部步骤失败。
打开火山引擎控制台→进入对应产品页（如“视频直播”“机器学习平台”“大模型精调”），在左侧导航栏点击“SDK下载”或“快速入门”，页面顶部会明确标注适用语言与场景。
安装对应SDK包
方法一：NPM方式（适用于微信/抖音小程序）
在小程序项目根目录执行：npm i veplayer-live-mp-wx
完成后，在微信开发者工具中点击菜单栏「工具」→「构建 npm」。
方法二：Go Modules方式（适用于视频点播服务端）
终端执行：go get github.com/volcengine/volc-sdk-golang
【必须使用v1.0.113或更新版本】，旧版本不支持部分新接口。
方法三：pip安装（适用于Python机器学习平台）
执行：wget https://ml-platform-public-examples-cn-beijing.tos-cn-beijing.volces.com/python_sdk_installer/volcengine_ml_platform-1.1.15-py3-none-any.whlpip3 install volcengine_ml_platform-1.1.15-py3-none-any.whl -i https://pypi.tuna.tsinghua.edu.cn/simple
配置访问凭证（AK/SK）
第一步：获取密钥
登录火山引擎控制台→右上角头像→「密钥管理」→创建AccessKey，记录下AccessKey ID和SecretAccessKey。
第二步：选择配置方式
推荐环境变量方式（安全且无需改代码）：export VOLC_ACCESSKEY="your_ak_here"export VOLC_SECRETKEY="your_sk_here"export VOLC_REGION="cn-beijing"
第三步：验证配置有效性
运行一段最简调用代码，例如Node.js中：const { VolcClient } = require('@volcengine/openapi'); const client = new VolcClient({ region: 'cn-beijing' }); client.request('DescribeRegions', {}).then(console.log);
若返回region列表即为成功；若报错Unauthorized，说明AK/SK未生效或权限不足。
在代码中初始化并调用服务
以微信小程序拉流SDK为例：
① 在页面json文件中声明组件：{"usingComponents": {"ve-live-player": "veplayer-live-mp-wx/ve-live-player/ve-live-player"}}
② 在wxml中插入播放器并传入FLV/RTMP地址：<ve-live-player autoplay src="%7B%7Bsrc%7D%7D"></ve-live-player>
其中src必须是火山引擎视频直播控制台生成的有效拉流地址，形如rtmp://xxx.live.volcfcdn.com/live/xxx。
③ 在js文件中绑定数据：Page({ data: { src: 'rtmp://xxx.live.volcfcdn.com/live/xxx' } })
这一步操作起来很简单，直接把拉流地址填进src即可播放；但若地址格式错误或未在控制台开启HTTPS/域名CNAME，将黑屏无任何报错提示。
