chanjing-customised-person

# 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：从本地视频创建定制数字人 ```bash 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：查看完整详情 ```bash python3 scripts/get_person \ --id "C-ef91f3a6db3144ffb5d6c581ff13c7ec" ``` 示例 3：列出与删除 ```bash 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`