- name
- chanjing-text-to-digital-person
- description
- Use Chanjing text-to-digital-person APIs to create AI portrait images, turn them into talking videos, optionally run LoRA training, poll async tasks, and explicitly download generated assets when requested.
- metadata
- openclaw
- requires
- env
- homepage
- https://open-api.chanjing.cc
Chanjing Text To Digital Person
When to Use This Skill
当用户要做这些事时使用本 Skill：
- 根据人物提示词生成数字人形象图
- 把生成的人物图转成会说话的短视频
- 查询文生图 / 图生视频 / LoRA 任务状态
- 在用户明确要求时，把生成图片或视频下载到本地
如果需求是“上传真人素材训练定制数字人”，优先使用 chanjing-customised-person。 如果需求是“拿已有数字人做口播视频合成”，优先使用 chanjing-video-compose。
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
主流程通常分两段，且都是异步任务：
- 调用
create_photo_task创建文生图任务，得到photo_unique_id - 调用
poll_photo_task轮询到成功，选一张photo_path - 调用
create_motion_task创建图生视频任务，得到motion_unique_id - 调用
poll_motion_task轮询到成功，得到最终video_url - 只有在用户明确要求保存到本地时，才调用
download_result
可选扩展：
- 若用户想做 LoRA 训练，调用
create_lora_task和poll_lora_task poll_lora_task成功后会返回一条photo_task_id，可继续用poll_photo_task拿图
Covered APIs
本 Skill 当前覆盖：
POST /open/v1/aigc/photoGET /open/v1/aigc/photo/taskGET /open/v1/aigc/photo/task/pagePOST /open/v1/aigc/motionGET /open/v1/aigc/motion/taskPOST /open/v1/aigc/lora/task/createGET /open/v1/aigc/lora/task
Scripts
脚本目录：
scripts/
| 脚本 | 说明 |
|---|---|
chanjing-config | 写入/查看本地 app_id 与 secret_key，并清理旧 token 缓存 |
chanjing-get-token | 从本地凭证获取有效 access_token（必要时自动刷新） |
_auth.py | 读取凭证、获取或刷新 access_token |
create_photo_task | 创建文生图任务，输出 photo_unique_id |
get_photo_task | 获取单个文生图任务详情 |
list_tasks | 列出文生图任务列表；返回中 type=1 为 photo，type=2 为 motion |
poll_photo_task | 轮询文生图任务直到完成，默认输出第一张图片地址 |
create_motion_task | 创建图生视频任务，输出 motion_unique_id |
get_motion_task | 获取单个图生视频任务详情 |
poll_motion_task | 轮询图生视频任务直到完成，默认输出视频地址 |
create_lora_task | 创建 LoRA 训练任务，输出 lora_id |
get_lora_task | 获取 LoRA 任务详情 |
poll_lora_task | 轮询 LoRA 任务直到完成，默认输出第一条 photo_task_id |
download_result | 下载图片或视频到 outputs/text-to-digital-person/ |
Usage Examples
示例 1：文生图后直接图生视频
PHOTO_TASK_ID=$(python3 scripts/create_photo_task \
--age "Young adult" \
--gender Female \
--number-of-images 1 \
--industry "教育培训" \
--background "现代直播间背景" \
--detail "短发，亲和力强，职业装" \
--talking-pose "上半身特写，站立讲解")
PHOTO_URL=$(python3 scripts/poll_photo_task \
--unique-id "$PHOTO_TASK_ID")
MOTION_TASK_ID=$(python3 scripts/create_motion_task \
--photo-unique-id "$PHOTO_TASK_ID" \
--photo-path "$PHOTO_URL" \
--emotion "自然播报，语气清晰自信" \
--gesture)
python3 scripts/poll_motion_task \
--unique-id "$MOTION_TASK_ID"示例 2：LoRA 训练
LORA_ID=$(python3 scripts/create_lora_task \
--name "演示LoRA" \
--photo-url https://example.com/1.jpg \
--photo-url https://example.com/2.jpg \
--photo-url https://example.com/3.jpg \
--photo-url https://example.com/4.jpg \
--photo-url https://example.com/5.jpg)
python3 scripts/poll_lora_task \
--lora-id "$LORA_ID"Download Rule
下载是显式动作，不是默认动作：
poll_photo_task和poll_motion_task成功后应先返回远端 URL- 不要自动下载结果文件
- 只有当用户明确表达“下载到本地”“保存到 outputs”“帮我落盘”时，才执行
download_result
Output Convention
默认本地输出目录：
outputs/text-to-digital-person/
Additional Resources
更多接口细节见：
reference.mdexamples.md