digital-human-video-init

name	digital-human-video-init
description	初始化数字人视频技能的凭据与配置:收集火山引擎 API Key(VOLC_AK/SK)、可选豆包 TTS 凭据、素材服务器配置,写入本机配置文件并做零成本连通性验证。当用户要"初始化视频技能/配置视频 API key/换视频密钥"时使用。只在本轮首次配置或换钥时用;日常做视频用 digital-human-video。

数字人视频技能 · 初始化

为 digital-human-video 技能准备凭据与配置。配置文件:~/.config/zmh-dhv/env(chmod 600,shell env 格式,制作技能的所有脚本会自动读取)。

流程

1. 收集凭据(让用户在聊天里逐项提供;缺哪项问哪项,已配置项显示「已配置」并询问是否覆盖):

   • VOLC_AK / VOLC_SK(必填):火山引擎控制台 → 访问控制 → API 密钥管理。提醒用户:企业主账号的 AK/SK 权限很大,若在意最小权限,可建 IAM 子用户只授权视觉智能(cv)服务后用子用户密钥。
   • TTS_APPID / TTS_TOKEN(可选):豆包语音合成(语音技术控制台)。不配则制作技能自动用免费 edge-tts。
   • TTS_VOICE(可选):豆包音色代号,默认 zh_female_shuangkuaisisi_moon_bigtts。
   • ZMH_ASSET_SSH / ZMH_ASSET_DIR / ZMH_ASSET_URLBASE(必填):素材临时上传的服务器与公网 URL 前缀(即梦 API 只收公网 URL)。默认 SSH 目标 zmh;目录与 URL 前缀须与用户确认真实站点路径,不得瞎猜。
   • AIGC_PRODUCER(可选):隐式 AI 标识里的服务商标识,默认 zhimahang。
   • BRAND_CTA(可选):口播结尾的固定引导语,如「搜 XX」。不配则制作技能每次问你要一句(或不加),不会自行编造。

2. 写配置:写入 ~/.config/zmh-dhv/env,chmod 600。密钥值不回显、不写入任何 git 仓、不进对话记录以外的文件。已有文件先备份为 env.bak。

3. 零成本验证:python3 scripts/validate.py(在本技能 scripts/ 下)。它用假 task_id 调一次 CVGetResult——不产生任何生成费用:

   • 返回鉴权类错误 → AK/SK 不对,让用户重查;
   • 返回「服务未开通」类错误 → 密钥有效但即梦AI「数字人快速模式」还没开通,引导用户去控制台开通(条款须用户本人点);
   • 返回 task 不存在/参数类业务错误 → 鉴权与服务通,初始化成功。 若配置了 TTS,再跑 python3 validate.py --tts,合成一个字验证(费用忽略不计)。 若配置了素材服务器,ssh 测目录可写、curl -I 测 URL 前缀可达。

4. 收尾:报告各项状态(✅/⚠️);提醒余额(数字人 1 元/秒,余额在 console.volcengine.com 首页看);之后用 digital-human-video 技能做视频。

红线

• 绝不主动向用户索要密码/登录凭据;只收 API 密钥这类用户主动交给自动化用的凭据。
• 密钥只落在 ~/.config/zmh-dhv/env(600 权限)一处;报告状态时只说「已配置」,不复述密钥内容。
• 验证阶段禁止调用任何计费生成接口(CVSubmitTask 一次都不许)。