chanjing-customised-person

Name: chanjing-customised-person
Author: chanjing-ai

40installs3forks

How to install chanjing-customised-person?

chanjing-ai/chan-skills/chanjing-customised-person

$npx -y skills add chanjing-ai/chan-skills --skill chanjing-customised-person

Installs into the current project.

Summary

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

Files · 1

View on GitHub

SKILL.md

1	# Chanjing Customised Person
2
3	## 功能说明
4
5	从本机上传源视频创建蝉镜定制数字人，并支持列表、查询、轮询与删除；流程与 Open API 一致：获取上传 URL（`create_upload_url`）→ 对返回的 `sign_url` 发起 `PUT` 上传正文 → 创建/列出/获取/轮询/删除。仅使用蝉镜 Open API 与接口返回的上传端点，不引入其它云厂商凭证。脚本不依赖 ffmpeg/ffprobe。环境变量均可选（默认 `~/.chanjing` 与官方 API 基址）。凭据、令牌持久化、网络边界见 `manifest.yaml`。
6
7	## 运行依赖
8
9	- python3 与同仓库 `scripts/*.py`；可读本地视频文件路径并上传
10
11	## 环境变量与机器可读声明
12
13	- 环境变量键名与说明：`manifest.yaml`（`environment` 段）及本文
14	- 变量键名、凭据模型、合规 `permissions`、`clientPermissions`、`agentPolicy`：`manifest.yaml`
15
16	## 使用命令
17
18	- ClawHub（slug 以注册表为准）：`clawhub run chanjing-customised-person`
19	- 本仓库：`python skills/chanjing-customised-person/scripts/create_person.py …`（见 Standard Workflow）
20
21	---
22
23	## 登记与审稿（单一事实来源）
24
25	英文登记、主凭据、`primaryEnv` 省略、可选 env、敏感字段与出站边界：以同目录 `manifest.yaml` 为准（与 `credential_hint`、`description` frontmatter 一致）。本篇从 When to Use 起写业务能力与流程，勿与 `manifest.yaml` 重复维护长篇对表。
26
27	## When to Use This Skill
28
29	当用户要做这些事时使用本 Skill：
30
31	* 上传真人源视频，创建蝉镜定制数字人
32	* 查询定制数字人列表或单个形象详情
33	* 轮询定制数字人制作进度
34	* 删除不再需要的定制数字人
35
36	如果需求是“拿已有数字人去合成口播视频”，优先使用 `chanjing-video-compose`。
37	如果需求是“上传真人视频做对口型驱动”，优先使用 `chanjing-avatar`。
38
39	## Preconditions
40
41	执行本 Skill 前，必须先通过 `chanjing-credentials-guard` 完成 AK/SK 与 Token 校验。
42
43	本 Skill 与 guard 共用：
44
45	* `~/.chanjing/credentials.json`
46	* `https://open-api.chanjing.cc`
47
48	无凭证时，脚本会自动打开蝉镜登录页，并提示配置命令。
49
50	### 审阅与安全（凭据与边界）
51
52	与 Purpose / Credentials / Persistence / Network 相关的逐项说明见 `manifest.yaml`（含 `permissions.network_mode: open` 与 `signUrlPutNote`）。以下仅 SKILL 正文补充：
53
54	- `credentials.json`：脚本会读取本地凭据；刷新后的 `access_token` / `expire_in` 写回同一文件为预期行为。须限制目录/文件权限（如目录 `0700`、文件 `0600`），并确保永不提交版本库（见 manifest `doNotCommitToVcs`）。
55	- `sign_url` 与 PUT 主机：`upload_file.py` / `get_upload_url.py` 先请求 `open-api.chanjing.cc` 的 `create_upload_url`，再向响应中的 `sign_url` 发起 HTTPS PUT；该 URL 的主机常为蝉镜侧对象存储或 CDN，可能不在固定主机白名单中，清单中已改为 `network_mode: open` 以如实声明。
56	- `create_person.py --callback`：若传入 URL，远程服务可能向该端点 POST 任务结果，载荷可能含状态与资源引用等敏感信息；须自行信任该端点并承担出站与数据暴露风险。
57	- 本地视频：仅按用户给出的路径读取视频字节并上传到 API 指定端点；不扫描其它无关系统路径。
58
59	## Standard Workflow
60
61	1. 上传本地源视频，获取 `file_id`（推荐 `upload_file.py`：内部为 `GET …/create_upload_url` → `PUT sign_url`（正文为文件）→ 轮询 `file_detail` 至就绪；亦可分步用 `get_upload_url.py` + 自行 PUT + 轮询）
62	2. 调用 `create_person.py` 创建定制数字人任务，得到 `person_id`
63	3. 调用 `poll_person.py` 轮询直到成功，得到 `preview_url`，或用 `get_person --field audio_man_id` 拿到声音 id
64	4. 如需批量查看历史形象，用 `list_persons.py`
65	5. 如需清理资源，用 `delete_person.py`
66
67	## Covered APIs
68
69	本 Skill 当前覆盖：
70
71	* `GET /open/v1/common/create_upload_url`
72	* `GET /open/v1/common/file_detail`
73	* `POST /open/v1/create_customised_person`
74	* `POST /open/v1/list_customised_person`
75	* `GET /open/v1/customised_person`
76	* `POST /open/v1/delete_customised_person`
77
78	## Scripts
79
80	脚本目录：
81
82	* `skills/chanjing-customised-person/scripts/`
83
84	\| 脚本 \| 说明 \|
85	\|------\|------\|
86	\| `_auth.py` \| 读取凭证、获取或刷新 `access_token` \|
87	\| `get_upload_url.py` \| 调用 `create_upload_url`，输出 `sign_url`、`mime_type`、`file_id` 等 JSON（需自行 PUT） \|
88	\| `upload_file.py` \| `create_upload_url` + HTTPS PUT `sign_url` + 轮询 `file_detail`，输出 `file_id` \|
89	\| `create_person.py` \| 创建定制数字人任务，输出 `person_id`；可选 `--callback`（服务端可能向该 URL POST 敏感任务载荷） \|
90	\| `list_persons.py` \| 列出定制数字人形象 \|
91	\| `get_person.py` \| 获取单个数字人详情，默认输出 JSON \|
92	\| `poll_person.py` \| 轮询形象详情直到完成，默认输出 `preview_url` \|
93	\| `delete_person.py` \| 删除定制数字人，输出被删除的 `person_id` \|
94
95	## Usage Examples
96
97	示例 1：从本地视频创建定制数字人
98
99	```bash
100	FILE_ID=$(python3 skills/chanjing-customised-person/scripts/upload_file.py \
101	--file ./source.mp4)
102
103	PERSON_ID=$(python3 skills/chanjing-customised-person/scripts/create_person.py \
104	--name "演示数字人" \
105	--file-id "$FILE_ID" \
106	--train-type figure)
107
108	python3 skills/chanjing-customised-person/scripts/poll_person.py --id "$PERSON_ID"
109	```
110
111	示例 2：查看完整详情
112
113	```bash
114	python3 skills/chanjing-customised-person/scripts/get_person.py \
115	--id "C-ef91f3a6db3144ffb5d6c581ff13c7ec"
116	```
117
118	示例 3：列出与删除
119
120	```bash
121	python3 skills/chanjing-customised-person/scripts/list_persons.py
122
123	python3 skills/chanjing-customised-person/scripts/delete_person.py \
124	--id "C-ef91f3a6db3144ffb5d6c581ff13c7ec"
125	```
126
127	## Output Convention
128
129	默认不自动下载

People who liked this also viewed

6 picks

Type

ai-video-generationinference.sh Agent skills for using our API to give your agents access to hundreds of apps and other agentsSkillsJul 2026292k642
imagegen-frontend-webElite frontend image-direction skill for generating premium, conversion-aware website design references. CRITICAL OUTPUT RULE — generate ONE separate horizontal image FOR EVERY section. A landing pageSkillsJul 2026165k66k
hyperframes-mediaWrite HTML. Render video. Built for agents.SkillsJul 2026145k37k
media-useAgent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + leSkillsJul 2026144k37k
general-videoAuthor or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, staticSkillsJul 2026124k37k
product-launch-videoTurn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market,SkillsJul 2026121k37k

chanjing-customised-person

40installs3forks

View on GitHub

How to install chanjing-customised-person?

chanjing-ai/chan-skills/chanjing-customised-person

$npx -y skills add chanjing-ai/chan-skills --skill chanjing-customised-person

Installs into the current project.

Summary

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

Files · 1

View on GitHub

SKILL.md

1	# Chanjing Customised Person
2
3	## 功能说明
4
5	从本机上传源视频创建蝉镜定制数字人，并支持列表、查询、轮询与删除；流程与 Open API 一致：获取上传 URL（`create_upload_url`）→ 对返回的 `sign_url` 发起 `PUT` 上传正文 → 创建/列出/获取/轮询/删除。仅使用蝉镜 Open API 与接口返回的上传端点，不引入其它云厂商凭证。脚本不依赖 ffmpeg/ffprobe。环境变量均可选（默认 `~/.chanjing` 与官方 API 基址）。凭据、令牌持久化、网络边界见 `manifest.yaml`。
6
7	## 运行依赖
8
9	- python3 与同仓库 `scripts/*.py`；可读本地视频文件路径并上传
10
11	## 环境变量与机器可读声明
12
13	- 环境变量键名与说明：`manifest.yaml`（`environment` 段）及本文
14	- 变量键名、凭据模型、合规 `permissions`、`clientPermissions`、`agentPolicy`：`manifest.yaml`
15
16	## 使用命令
17
18	- ClawHub（slug 以注册表为准）：`clawhub run chanjing-customised-person`
19	- 本仓库：`python skills/chanjing-customised-person/scripts/create_person.py …`（见 Standard Workflow）
20
21	---
22
23	## 登记与审稿（单一事实来源）
24
25	英文登记、主凭据、`primaryEnv` 省略、可选 env、敏感字段与出站边界：以同目录 `manifest.yaml` 为准（与 `credential_hint`、`description` frontmatter 一致）。本篇从 When to Use 起写业务能力与流程，勿与 `manifest.yaml` 重复维护长篇对表。
26
27	## When to Use This Skill
28
29	当用户要做这些事时使用本 Skill：
30
31	* 上传真人源视频，创建蝉镜定制数字人
32	* 查询定制数字人列表或单个形象详情
33	* 轮询定制数字人制作进度
34	* 删除不再需要的定制数字人
35
36	如果需求是“拿已有数字人去合成口播视频”，优先使用 `chanjing-video-compose`。
37	如果需求是“上传真人视频做对口型驱动”，优先使用 `chanjing-avatar`。
38
39	## Preconditions
40
41	执行本 Skill 前，必须先通过 `chanjing-credentials-guard` 完成 AK/SK 与 Token 校验。
42
43	本 Skill 与 guard 共用：
44
45	* `~/.chanjing/credentials.json`
46	* `https://open-api.chanjing.cc`
47
48	无凭证时，脚本会自动打开蝉镜登录页，并提示配置命令。
49
50	### 审阅与安全（凭据与边界）
51
52	与 Purpose / Credentials / Persistence / Network 相关的逐项说明见 `manifest.yaml`（含 `permissions.network_mode: open` 与 `signUrlPutNote`）。以下仅 SKILL 正文补充：
53
54	- `credentials.json`：脚本会读取本地凭据；刷新后的 `access_token` / `expire_in` 写回同一文件为预期行为。须限制目录/文件权限（如目录 `0700`、文件 `0600`），并确保永不提交版本库（见 manifest `doNotCommitToVcs`）。
55	- `sign_url` 与 PUT 主机：`upload_file.py` / `get_upload_url.py` 先请求 `open-api.chanjing.cc` 的 `create_upload_url`，再向响应中的 `sign_url` 发起 HTTPS PUT；该 URL 的主机常为蝉镜侧对象存储或 CDN，可能不在固定主机白名单中，清单中已改为 `network_mode: open` 以如实声明。
56	- `create_person.py --callback`：若传入 URL，远程服务可能向该端点 POST 任务结果，载荷可能含状态与资源引用等敏感信息；须自行信任该端点并承担出站与数据暴露风险。
57	- 本地视频：仅按用户给出的路径读取视频字节并上传到 API 指定端点；不扫描其它无关系统路径。
58
59	## Standard Workflow
60
61	1. 上传本地源视频，获取 `file_id`（推荐 `upload_file.py`：内部为 `GET …/create_upload_url` → `PUT sign_url`（正文为文件）→ 轮询 `file_detail` 至就绪；亦可分步用 `get_upload_url.py` + 自行 PUT + 轮询）
62	2. 调用 `create_person.py` 创建定制数字人任务，得到 `person_id`
63	3. 调用 `poll_person.py` 轮询直到成功，得到 `preview_url`，或用 `get_person --field audio_man_id` 拿到声音 id
64	4. 如需批量查看历史形象，用 `list_persons.py`
65	5. 如需清理资源，用 `delete_person.py`
66
67	## Covered APIs
68
69	本 Skill 当前覆盖：
70
71	* `GET /open/v1/common/create_upload_url`
72	* `GET /open/v1/common/file_detail`
73	* `POST /open/v1/create_customised_person`
74	* `POST /open/v1/list_customised_person`
75	* `GET /open/v1/customised_person`
76	* `POST /open/v1/delete_customised_person`
77
78	## Scripts
79
80	脚本目录：
81
82	* `skills/chanjing-customised-person/scripts/`
83
84	\| 脚本 \| 说明 \|
85	\|------\|------\|
86	\| `_auth.py` \| 读取凭证、获取或刷新 `access_token` \|
87	\| `get_upload_url.py` \| 调用 `create_upload_url`，输出 `sign_url`、`mime_type`、`file_id` 等 JSON（需自行 PUT） \|
88	\| `upload_file.py` \| `create_upload_url` + HTTPS PUT `sign_url` + 轮询 `file_detail`，输出 `file_id` \|
89	\| `create_person.py` \| 创建定制数字人任务，输出 `person_id`；可选 `--callback`（服务端可能向该 URL POST 敏感任务载荷） \|
90	\| `list_persons.py` \| 列出定制数字人形象 \|
91	\| `get_person.py` \| 获取单个数字人详情，默认输出 JSON \|
92	\| `poll_person.py` \| 轮询形象详情直到完成，默认输出 `preview_url` \|
93	\| `delete_person.py` \| 删除定制数字人，输出被删除的 `person_id` \|
94
95	## Usage Examples
96
97	示例 1：从本地视频创建定制数字人
98
99	```bash
100	FILE_ID=$(python3 skills/chanjing-customised-person/scripts/upload_file.py \
101	--file ./source.mp4)
102
103	PERSON_ID=$(python3 skills/chanjing-customised-person/scripts/create_person.py \
104	--name "演示数字人" \
105	--file-id "$FILE_ID" \
106	--train-type figure)
107
108	python3 skills/chanjing-customised-person/scripts/poll_person.py --id "$PERSON_ID"
109	```
110
111	示例 2：查看完整详情
112
113	```bash
114	python3 skills/chanjing-customised-person/scripts/get_person.py \
115	--id "C-ef91f3a6db3144ffb5d6c581ff13c7ec"
116	```
117
118	示例 3：列出与删除
119
120	```bash
121	python3 skills/chanjing-customised-person/scripts/list_persons.py
122
123	python3 skills/chanjing-customised-person/scripts/delete_person.py \
124	--id "C-ef91f3a6db3144ffb5d6c581ff13c7ec"
125	```
126
127	## Output Convention
128
129	默认不自动下载

People who liked this also viewed

6 picks

Type