- 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
- 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_urlGET /open/v1/common/file_detailPOST /open/v1/create_customised_personPOST /open/v1/list_customised_personGET /open/v1/customised_personPOST /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_idpoll_person输出preview_url，便于继续预览或保存- 只有在用户明确要求时，才应把返回的资源 URL 另存到本地
如果后续需要落盘预览资源，建议使用：
outputs/customised-person/
Additional Resources
更多接口细节与触发样例见：
reference.mdexamples.md