Zyt customised person

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

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

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