用途:调用蝉镜视频合成 Open API,创建数字人视频合成任务,可用文本或本地音频驱动数字人出镜,支持可选背景上传、任务轮询与显式下载。
主要能力:列举公共或定制数字人形象;上传音频、背景素材获取 file_id;创建视频合成任务;轮询任务直到完成并返回 video_url;在用户明确要求时下载成片。覆盖接口包括 GET /open/v1/list_common_dp、POST /open/v1/list_customised_person、POST /open/v1/create_video、GET /open/v1/video、GET /open/v1/common/create_upload_url、GET /open/v1/common/file_detail。
使用方式:依赖 python3 与同仓库 scripts/*.py,不依赖 ffmpeg/ffprobe。执行前须通过 chanjing-credentials-guard 完成 AK/SK 与 Token 校验,共用 ~/.chanjing/credentials.json 与 https://open-api.chanjing.cc。可用 clawhub run chanjing-video-compose,或直接运行脚本,如 python skills/chanjing-video-compose/scripts/list_figures.py --source common、create_task.py、poll_task.py、download_result.py。
流程要点:先让用户选择数字人来源 common 或 customised,比较候选后选定 person.id;公共数字人需确认 figure_type;文本驱动需确定 audio_man_id;创建任务前必须询问字幕偏好 show 或 hide;本地音频或背景图先经 upload_file.py 获取 file_id;创建任务得到 video_id 后轮询至成功取得 video_url;仅当用户明确要求保存到本地时才下载。
限制:下载为显式动作,不自动执行;字幕坐标以左上角为原点且不能超出画布;若需求是上传真人视频做对口型驱动,应使用 chanjing-avatar,不要混用。凭据与权限边界以 manifest.yaml 为准。