chanjing-avatar

Use Chanjing Avatar API for lip-syncing video generation

설치로 이동

저장소: GeorgeDoors888/GB-Power-Market-JJ
최근 소스 활동: 2026년 4월 16일 00:11
감지된 SKILL.md 언어: 영어
스타: 3
포크: 1

설치 방법

기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.

npx skills add https://github.com/GeorgeDoors888/GB-Power-Market-JJ --skill chanjing-avatar

명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.

로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.

소스 파일 검토

설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.

파일 탐색기

3 개 파일

SKILL.md

소스 지침 · 읽기 전용 미리보기

검색으로 돌아가기 설치로 돌아가기

name	chanjing-avatar
description	Use Chanjing Avatar API for lip-syncing video generation

Chanjing Avatar (Lip-Syncing)

When to Use This Skill

Use this skill when the user needs to create lip-syncing videos (digital avatar videos) with synchronized mouth movements.

Chanjing Avatar supports:

Text-driven or audio-driven lip-syncing
Multiple system voices for TTS
Video resolution customization
Task status polling and callback

How to Use This Skill

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

Multiple APIs need to be invoked. All share the domain: "https://open-api.chanjing.cc". All requests communicate using json. You should use utf-8 to encode and decode text throughout this task.

Obtain an access_token, which is required for all subsequent API calls
Upload your video/audio files using the File Management API to get file_id
Create a lip-syncing task with video and audio/text using these file_id values
Poll the Query Task Detail API or use Task List API to check status
Download the generated video using the url in response when status is completed

Obtain AccessToken

从 ~/.chanjing/credentials.json 读取 app_id 和 secret_key，若无有效 Token 则调用：

POST /open/v1/access_token
Content-Type: application/json

请求体（使用本地配置的 app_id、secret_key）：

{
  "app_id": "<从 credentials.json 读取>",
  "secret_key": "<从 credentials.json 读取>"
}

Response example:

{
  "trace_id": "8ff3fcd57b33566048ef28568c6cee96",
  "code": 0,
  "msg": "success",
  "data": {
    "access_token": "1208CuZcV1Vlzj8MxqbO0kd1Wcl4yxwoHl6pYIzvAGoP3DpwmCCa73zmgR5NCrNu",
    "expire_in": 1721289220
  }
}

Response field description:

First-level Field	Second-level Field	Description
code		Response status code
msg		Response message
data		Response data
	access_token	Valid for one day, previous token will be invalidated
	expire_in	Token expiration time

Response Status Code Description

Code	Description
0	Success
400	Invalid parameter format
40000	Parameter error
50000	System internal error

Upload Media Files (File Management)

Before creating a lip-syncing task, you must upload your video (and optional audio) files using the File Management API to obtain file_id values.

The full documentation is here: [File Management](https://doc.chanjing.cc/api/file/file-management.html).

Step 1: Get upload URL

GET /open/v1/common/create_upload_url
access_token: {{access_token}}

Query params:

Key	Example	Description
service	lip_sync_video / lip_sync_audio	File usage purpose. Use `lip_sync_video` for driving video, `lip_sync_audio` for audio (if audio-driven).
name	1.mp4	Original file name including extension

You will get a response containing sign_url, mime_type, and file_id. Use the sign_url with HTTP PUT to upload the file, setting Content-Type to the returned mime_type. After the PUT completes, poll the file detail API until the file is ready (do not assume a fixed wait). Keep the returned file_id for video_file_id / audio_file_id below.

Polling: Call GET /open/v1/common/file_detail?id={{file_id}} with access_token until the response data.status indicates success (e.g. status === 2). Only then use the file_id for the create task API.

Create Lip-Syncing Task

Submit a lip-syncing video creation task, which returns a video ID for polling later.

POST /open/v1/video_lip_sync/create
access_token: {{access_token}}
Content-Type: application/json

Request body example (TTS-driven):

{
  "video_file_id": "e284db4d95de4220afe78132158156b5",
  "screen_width": 1080,
  "screen_height": 1920,
  "callback": "https://example.com/openapi/callback",
  "model": 0,
  "audio_type": "tts",
  "tts_config": {
    "text": "君不见黄河之水天上来，奔流到海不复回。",
    "audio_man_id": "C-f2429d07554749839849497589199916",
    "speed": 1,
    "pitch": 1
  }
}

Request body example (Audio-driven):

{
  "video_file_id": "e284db4d95de4220afe78132158156b5",
  "screen_width": 1080,
  "screen_height": 1920,
  "model": 0,
  "audio_type": "audio",
  "audio_file_id": "audio_file_id_from_file_management"
}

Request field description:

Parameter Name	Type	Required	Description
video_file_id	string	Yes	Video file ID from File Management (`data.file_id`). Supports mp4, mov, webm
screen_width	int	No	Screen width, default 1080
screen_height	int	No	Screen height, default 1920
backway	int	No	Playback order when reaching end: 1-normal, 2-reverse. Default 1
drive_mode	string	No	Drive mode: ""-normal, "random"-random frame. Default ""
callback	string	No	Callback URL for async notification
model	int	No	Model version: 0-basic, 1-high quality. Default 0
audio_type	string	No	Audio type: "tts"-text driven, "audio"-audio driven. Default "tts"
tts_config	object	Yes (for tts)	TTS configuration when audio_type="tts"
tts_config.text	string	Yes (for tts)	Text to synthesize
tts_config.audio_man_id	string	Yes (for tts)	Voice ID
tts_config.speed	number	No	Speech speed: 0.5-2, default 1
tts_config.pitch	number	No	Pitch, default 1
audio_file_id	string	Yes (for audio)	Audio file ID from File Management (`data.file_id`) when `audio_type="audio"`. Supports mp3, m4a, wav
volume	int	No	Volume: 1-100, default 100

Response example:

{
  "trace_id": "8d10659438827bd4d59eaa2696f9d391",
  "code": 0,
  "msg": "success",
  "data": "9499ed79995c4bdb95f0d66ca84419fd"
}

Response field description:

Field	Description
code	Response status code
msg	Response message
data	Video ID for subsequent polling

Query Task List

Get a list of lip-syncing tasks.

POST /open/v1/video_lip_sync/list
access_token: {{access_token}}
Content-Type: application/json

Request body:

{
  "page": 1,
  "page_size": 10
}

Request field description:

Parameter	Type	Required	Description
page	int	No	Page number, default 1
page_size	int	No	Page size, default 10

Response example:

{
  "trace_id": "8d10659438827bd4d59eaa2696f9d391",
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": "9499ed79995c4bdb95f0d66ca84419fd",
        "status": 20,
        "progress": 100,
        "msg": "success",
        "video_url": "https://res.chanjing.cc/xxx/lip-sync/9499ed79995c4bdb95f0d66ca84419fd.mp4",
        "preview_url": "https://res.chanjing.cc/xxx/lip-sync/9499ed79995c4bdb95f0d66ca84419fd.jpg",
        "duration": 300,
        "create_time": 1738636800
      }
    ],
    "page_info"

Response field description:

First-level Field	Second-level Field	Description
code		Response status code
msg		Response message
data		Response data
	list	Task list
		id: Video ID
		status: Task status (0-pending, 10-generating, 20-success, 30-failed)
		progress: Progress 0-100
		msg: Task message
		video_url: Video download URL
		preview_url: Cover image URL
		duration: Video duration in ms
		create_time: Creation time (unix timestamp)
	page_info	Pagination info

Query Task Detail

Poll the following API to check task status until completed.

GET /open/v1/video_lip_sync/detail
access_token: {{access_token}}

Query params:

Parameter	Description
id	Video ID

Example: GET /open/v1/video_lip_sync/detail?id=9499ed79995c4bdb95f0d66ca84419fd

Response example:

{
  "trace_id": "8d10659438827bd4d59eaa2696f9d391",
  "code": 0,
  "msg": "success",
  "data": {
    "id": "9499ed79995c4bdb95f0d66ca84419fd",
    "status": 20,
    "progress": 100,
    "msg": "success",
    "video_url": "https://res.chanjing.cc/xxx/lip-sync/9499ed79995c4bdb95f0d66ca84419fd.mp4",
    "preview_url": "https://res.chanjing.cc/xxx/lip-sync/9499ed79995c4bdb95f0d66ca84419fd.jpg",
    "duration": 300,
    "create_time": 1738636800
  }
}

Response field description:

First-level Field	Second-level Field	Description
code		Response status code
msg		Response message
data		Response data
	id	Video ID
	status	Task status: 0-pending, 10-generating, 20-success, 30-failed
	progress	Progress 0-100
	msg	Task message
	video_url	Video download URL
	preview_url	Cover image URL
	duration	Video duration in ms
	create_time	Creation time (unix timestamp)

Callback Notification

When a callback URL is provided, the system will send a POST request when the task completes:

{
  "trace_id": "8d10659438827bd4d59eaa2696f9d391",
  "code": 0,
  "msg": "success",
  "data": {
    "id": "9499ed79995c4bdb95f0d66ca84419fd",
    "status": 20,
    "progress": 100,
    "msg": "success",
    "video_url": "https://res.chanjing.cc/xxx/lip-sync/9499ed79995c4bdb95f0d66ca84419fd.mp4",
    "preview_url": "https://res.chanjing.cc/xxx/lip-sync/9499ed79995c4bdb95f0d66ca84419fd.jpg",
    "duration": 300,
    "create_time": 1738636800
  }
}

Scripts

本 Skill 提供脚本（skills/chanjing-avatar/scripts/），与 chanjing-credentials-guard 使用同一配置文件（~/.chanjing/credentials.json）获取 Token。

脚本	说明
`get_upload_url`	获取上传链接，输出 `sign_url`、`mime_type`、`file_id`
`upload_file`	上传本地文件，轮询 file_detail 直到就绪后输出 `file_id`
`create_task`	创建对口型任务（TTS 或音频驱动），输出视频任务 id
`poll_task`	轮询任务直到完成，输出 `video_url`

示例（在项目根或 skill 目录下执行）：

# 1. 上传驱动视频，得到 video_file_id
VIDEO_FILE_ID=$(python skills/chanjing-avatar/scripts/upload_file --service lip_sync_video --file ./my_video.mp4)

# 2. 创建 TTS 对口型任务（需先通过 list_common_audio 获取 audio_man_id）
TASK_ID=$(python skills/chanjing-avatar/scripts/create_task \
  --video-file-id "$VIDEO_FILE_ID" \
  --text "君不见黄河之水天上来" \
  --audio-man-id "C-f2429d07554749839849497589199916")

# 3. 轮询直到完成，得到视频下载链接
python skills/chanjing-avatar/scripts/poll_task --id "$TASK_ID"

音频驱动时：先上传音频得到 audio_file_id，再 create_task --video-file-id <id> --audio-file-id <audio_file_id>。

Response Status Code Description

Code	Description
0	Response successful
10400	AccessToken verification failed
40000	Parameter error
40001	Exceeds RPM/QPS limit
50000	System internal error

chanjing-avatar

소스 정보

설치 방법

소스 파일 검토

이 저장소의 다른 Skills

이 저장소의 다른 Skills

Chanjing Avatar (Lip-Syncing)

When to Use This Skill

How to Use This Skill

Obtain AccessToken

Upload Media Files (File Management)

Step 1: Get upload URL

Create Lip-Syncing Task

Query Task List

Query Task Detail

Callback Notification

Scripts

Response Status Code Description

Chanjing Avatar (Lip-Syncing)

When to Use This Skill

How to Use This Skill

Obtain AccessToken

Upload Media Files (File Management)

Step 1: Get upload URL

Create Lip-Syncing Task

Query Task List

Query Task Detail

Callback Notification

Scripts

Response Status Code Description