chanjing-text-to-digital-person git:20260318.2e2720aA

Immutable. This exact content never changes and is served at /api/v1/blob/6ece47de2b7f8550.

---
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：文生图后直接图生视频

```bash
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 训练

```bash
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`