蝉镜定制数字人

何时使用本技能

当用户要做这些事时使用本技能：

• * 上传真人源视频，创建蝉镜定制数字人
• 查询定制数字人列表或单个形象详情
• 轮询定制数字人制作进度
• 删除不再需要的定制数字人

如果需求是拿已有数字人去合成口播视频，优先使用 chanjing-video-compose。
如果需求是上传真人视频做对口型驱动，优先使用 chanjing-avatar。

前置条件

本技能自身包含本地配置和鉴权流程，不依赖其他技能的运行时脚本。

本技能使用：

• * 配置文件：~/.chanjing/credentials.json
• 若设置环境变量 CHANJINGCONFIGDIR：使用 $CHANJINGCONFIGDIR/credentials.json
• API 基础地址固定：https://open-api.chanjing.cc

当本地缺少 AK/SK 或 AK/SK 无效时，脚本默认返回登录引导信息，不自动打开浏览器。
如需本地自动开页，可显式设置：CHANJINGAUTOOPEN_LOGIN=1。
https://www.chanjing.cc/openapi/login

标准工作流程

1. 1. 调用 uploadfile 上传本地源视频，获取 fileid
2. 调用 createperson 创建定制数字人任务，得到 personid
3. 调用 pollperson 轮询直到成功，得到 previewurl，或用 getperson --field audiomanid 拿到声音 id
4. 如需批量查看历史形象，用 listpersons
5. 如需清理资源，用 delete_person

覆盖的 API

本技能当前覆盖：

• * GET /open/v1/common/createuploadurl
• GET /open/v1/common/filedetail
• POST /open/v1/createcustomisedperson
• POST /open/v1/listcustomisedperson
• GET /open/v1/customisedperson
• POST /open/v1/deletecustomisedperson

脚本

脚本目录：

• * scripts/

使用示例

示例 1：从本地视频创建定制数字人

bash
FILEID=$(python3 scripts/uploadfile \
--file ./source.mp4)

PERSONID=$(python3 scripts/createperson \
--name 演示数字人 \
--file-id $FILE_ID \
--train-type figure)

python3 scripts/pollperson --id $PERSONID

示例 2：查看完整详情

bash
python3 scripts/get_person \
--id C-ef91f3a6db3144ffb5d6c581ff13c7ec

示例 3：列出与删除

bash
python3 scripts/list_persons

python3 scripts/delete_person \
--id C-ef91f3a6db3144ffb5d6c581ff13c7ec

输出约定

默认不自动下载任何预览视频或封面图：

• * createperson 输出 personid
• pollperson 输出 previewurl，便于继续预览或保存
• 只有在用户明确要求时，才应把返回的资源 URL 另存到本地

如果后续需要落盘预览资源，建议使用：

• * outputs/customised-person/

附加资源

更多接口细节与触发样例见：

• * reference.md
• examples.md