人脸变换

本项目介绍基于USB摄像头的人脸变换功能及使用方法。该功能通过云端接口实现人脸效果处理，并提供图形化交互界面，帮助用户快速部署与验证效果。完成环境准备、依赖安装和参数配置后，可在Quectel Pi H1智能主控板上运行项目，复现人脸变换效果并输出结果。

当前支持的核心功能：

• 人脸年龄变化：生成不同年龄阶段的人脸效果，并合成视频播放；
• 人像动漫化：将人像转换为动漫风格图片；
• 人脸性别转换：以整图方式生成单张人脸的性别转换结果。

此外，该项目支持自动识别并启用摄像头设备，同时输出运行状态与日志信息，便于用户监控任务进度及排查问题。

开发配件清单

开发配件只是作为参考，不同的开发环境可能会有所差异，比如通过SSH远程连接进行开发，可以不使用USB拓展板，显示屏也可以根据需要进行替换。

配件名称	数量	规格参数
Quectel Pi H1智能主控板	1 块	Quectel Pi H1智能主控板
USB摄像头？	1 个	OV5693 USB摄像头？
电源适配器	1 个	27 W USB Type-C接口充电器 1.2 米线长中规电源PD电源 适用于树莓派 5 代
CPU散热风扇	1 个	树莓派 5 代官方原装散热器带导热贴
HDMI线	1 根	HDMI 2.0；线长 1 m；接口：HDMI-A（公头）-HDMI-D（公头）
网线	1 根	线长：1 m；传输速率：千兆
显示屏	1 个	24 英寸HDMI显示器

配件实物参考

开发准备

Quectel Pi H1智能主控板出厂默认搭载Debian 13系统镜像，因此无需再次烧录镜像，仅需按照如下步骤操作即可。

硬件连接

散热风扇安装

将散热风扇的排线插入Quectel Pi H1智能主控板的FAN插槽，再将散热器两端固定在智能主控板预留的安装孔位，示意图如下：

摄像头连接

将USB摄像头直接接入智能主控板的USB-A接口即可。

显示连接

将HDMI线一端接入智能主控板的HDMI接口，另一端接入显示器的HDMI接口。

网络连接

将网线一端接入智能主控板的千兆网口，另一端接入已联网的路由器网口，确保设备可访问网络。

供电连接

将USB-C电源线的USB-A端接入电源适配器，USB-C端接入智能主控板标注“POWER IN”的电源接口。

连接完成参考

硬件全部连接完成后，参考示意图如下：

项目实现

更新软件源

执行以下命令更新系统软件源：

sudo apt update

安装系统依赖

安装基础依赖包：

安装图形界面相关依赖：

sudo apt install -y libxcb-cursor0 libxkbcommon-x11-0 \

创建虚拟环境

新建项目目录：

进入项目目录并创建Python虚拟环境：

激活虚拟环境

下载示例代码

更新pip源

安装项目依赖库

配置密钥

使用人脸变换服务需先开通腾讯云相关服务，并获取API调用密钥（SecretId和SecretKey），获取路径：腾讯云访问管理控制台。

参考文档：腾讯云人像变换API文档

方式1：通过环境变量读取密钥（示例）：

export TENCENTCLOUD_SECRET_ID="SecretId"

export TENCENTCLOUD_SECRET_KEY="SecretKey"

方式2：通过启动脚本配置

编辑start.sh脚本，填入SecretId和SecretKey：

运行程序

在start.sh里面配置好SecretId和SecretKey

图形界面远程运行配置

为使SSH远程会话能够正常运行本地图形界面程序，需完成以下配置：

1.在设备本地桌面终端中执行权限配置命令

该命令允许本地用户pi访问当前X11显示服务。

2.在SSH远程会话中设置图形显示环境变量

export DISPLAY=:0

export XAUTHORITY=/home/pi/.Xauthority

配置完成后，即可在SSH会话中运行需要图形界面的程序。