chanjing-text-to-digital-person

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.

Chanjing Text To Digital Person

When to Use This Skill

当用户要做这些事时使用本 Skill：

• 根据人物提示词生成数字人形象图
• 把生成的人物图转成会说话的短视频
• 查询文生图 / 图生视频 / LoRA 任务状态
• 在用户明确要求时，把生成图片或视频下载到本地

如果需求是“上传真人素材训练定制数字人”，优先使用 chanjing-customised-person。
如果需求是“拿已有数字人做口播视频合成”，优先使用 chanjing-video-compose。

Preconditions

执行本 Skill 前，必须先通过 chanjing-credentials-guard 完成 AK/SK 与 Token 校验。

本 Skill 与 guard 共用：

• ~/.chanjing/credentials.json
• https://open-api.chanjing.cc

无凭证时，脚本会自动打开蝉镜登录页，并提示配置命令。

Standard Workflow

主流程通常分两段，且都是异步任务：

1. 调用 create_photo_task 创建文生图任务，得到 photo_unique_id
2. 调用 poll_photo_task 轮询到成功，选一张 photo_path
3. 调用 create_motion_task 创建图生视频任务，得到 motion_unique_id
4. 调用 poll_motion_task 轮询到成功，得到最终 video_url
5. 只有在用户明确要求保存到本地时，才调用 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/photo
• GET /open/v1/aigc/photo/task
• GET /open/v1/aigc/photo/task/page
• POST /open/v1/aigc/motion
• GET /open/v1/aigc/motion/task
• POST /open/v1/aigc/lora/task/create
• GET /open/v1/aigc/lora/task

Scripts

脚本目录：

• skills/chanjing-text-to-digital-person/scripts/

脚本	说明
_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 skills/chanjing-text-to-digital-person/scripts/create_photo_task \
  --age "Young adult" \
  --gender Female \
  --number-of-images 1 \
  --industry "教育培训" \
  --background "现代直播间背景" \
  --detail "短发，亲和力强，职业装" \
  --talking-pose "上半身特写，站立讲解")

PHOTO_URL=$(python3 skills/chanjing-text-to-digital-person/scripts/poll_photo_task \
  --unique-id "$PHOTO_TASK_ID")

MOTION_TASK_ID=$(python3 skills/chanjing-text-to-digital-person/scripts/create_motion_task \
  --photo-unique-id "$PHOTO_TASK_ID" \
  --photo-path "$PHOTO_URL" \
  --emotion "自然播报，语气清晰自信" \
  --gesture)

python3 skills/chanjing-text-to-digital-person/scripts/poll_motion_task \
  --unique-id "$MOTION_TASK_ID"

示例 2：LoRA 训练

LORA_ID=$(python3 skills/chanjing-text-to-digital-person/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 skills/chanjing-text-to-digital-person/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

更多接口细节见：

• skills/chanjing-text-to-digital-person/reference.md
• skills/chanjing-text-to-digital-person/examples.md