Skills chanjing-customised-person

Use Chanjing customised person APIs to create, inspect, list, poll, and delete custom digital humans from uploaded source videos.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/binkes/chanjing-customised-person" ~/.claude/skills/clawdbot-skills-chanjing-customised-person && rm -rf "$T"

manifest: skills/binkes/chanjing-customised-person/SKILL.md

source content

Chanjing Customised Person

When to Use This Skill

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

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

如果需求是“拿已有数字人去合成口播视频”，优先使用

chanjing-video-compose

。
如果需求是“上传真人视频做对口型驱动”，优先使用

chanjing-avatar

。

Preconditions

执行本 Skill 前，必须先通过

chanjing-credentials-guard

完成 AK/SK 与 Token 校验。

本 Skill 与 guard 共用：

```
~/.chanjing/credentials.json
```
```
https://open-api.chanjing.cc
```

无凭证时，脚本会自动打开蝉镜登录页，并提示配置命令。

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

脚本目录：

skills/chanjing-customised-person/scripts/

脚本	说明
`_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 skills/chanjing-customised-person/scripts/upload_file \
  --file ./source.mp4)

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

python3 skills/chanjing-customised-person/scripts/poll_person --id "$PERSON_ID"

示例 2：查看完整详情

python3 skills/chanjing-customised-person/scripts/get_person \
  --id "C-ef91f3a6db3144ffb5d6c581ff13c7ec"

示例 3：列出与删除

python3 skills/chanjing-customised-person/scripts/list_persons

python3 skills/chanjing-customised-person/scripts/delete_person \
  --id "C-ef91f3a6db3144ffb5d6c581ff13c7ec"

Output Convention

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

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

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

```
outputs/customised-person/
```

Additional Resources

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

skills/chanjing-customised-person/reference.md

skills/chanjing-customised-person/examples.md