Zyt customised person

通过蝉镜开放接口上传本地源视频，创建、查询、轮询和删除定制数字人，输出形象 ID、预览地址和 JSON 详情；依赖本地 AK/SK 凭证与网络，当前文件列表缺少多个被引用的脚本。

zuoyuting214

热度 46.34

最近更新 2026-05-11 17:36:59

分类：创作依赖：代码执行 / 读写文件 / 第三方 API应用场景：视频编辑 / API 集成 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add zyt-customised-person

Metadata

name: chanjing-customised-person
description: Use Chanjing customised person APIs to create, inspect, list, poll, and delete custom digital humans from uploaded source videos.
metadata: {"openclaw":{"requires":{"env":["CHANJING_CONFIG_DIR"]},"homepage":"https://open-api.chanjing.cc"}}

Chanjing Customised Person

When to Use This Skill

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

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

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

Preconditions

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

本 Skill 使用：

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

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

Standard Workflow

调用 upload_file 上传本地源视频，获取 file_id
调用 create_person 创建定制数字人任务，得到 person_id
调用 poll_person 轮询直到成功，得到 preview_url，或用 get_person --field audio_man_id 拿到声音 id
如需批量查看历史形象，用 list_persons
如需清理资源，用 delete_person

Covered APIs

本 Skill 当前覆盖：

GET /open/v1/common/create_upload_url
GET /open/v1/common/file_detail
POST /open/v1/create_customised_person
POST /open/v1/list_customised_person
GET /open/v1/customised_person
POST /open/v1/delete_customised_person

Scripts

脚本目录：

scripts/

脚本	说明
`chanjing-config`	写入/查看本地 `app_id` 与 `secret_key`，并清理旧 token 缓存
`chanjing-get-token`	从本地凭证获取有效 `access_token`（必要时自动刷新）
`_auth.py`	读取凭证、获取或刷新 `access_token`
`get_upload_url`	获取上传链接，输出 `sign_url`、`mime_type`、`file_id` 等 JSON
`upload_file`	上传本地素材并轮询到文件可用，输出 `file_id`
`create_person`	创建定制数字人任务，输出 `person_id`
`list_persons`	列出定制数字人形象
`get_person`	获取单个数字人详情，默认输出 JSON
`poll_person`	轮询形象详情直到完成，默认输出 `preview_url`
`delete_person`	删除定制数字人，输出被删除的 `person_id`

Usage Examples

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

FILE_ID=$(python3 scripts/upload_file \
  --file ./source.mp4)

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

python3 scripts/poll_person --id "$PERSON_ID"

示例 2：查看完整详情

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

示例 3：列出与删除

python3 scripts/list_persons

python3 scripts/delete_person \
  --id "C-ef91f3a6db3144ffb5d6c581ff13c7ec"

Output Convention

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

create_person 输出 person_id
poll_person 输出 preview_url，便于继续预览或保存
只有在用户明确要求时，才应把返回的资源 URL 另存到本地

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

outputs/customised-person/

Additional Resources

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

reference.md
examples.md