| --- |
| license: other |
| library_name: pytorch |
| tags: |
| - audio-to-face |
| - flame |
| - arkit |
| - hubert |
| --- |
| |
| # FaceAnimator A2F runtime assets |
|
|
| 这是 `FaceAnimator_a2f_delivery` 的运行资产包。目录层级与代码实际加载路径一致；将本目录内容合并到代码仓库根目录即可，不需要改路径。 |
|
|
| ## 默认 HTTP fused 链路必需 |
|
|
| - `v1_inference/checkpoints/fix_b3_1009_step74000.pt` |
| - `v1_inference/models/chinese-hubert-base/{config.json,preprocessor_config.json,pytorch_model.bin}` |
| - `FaceAnimator-flame2bs/param_net/outputs/best_temporal_flame2bs.pth` |
| - `FaceAnimator-flame2bs/vertice_fit/FLAME/geometry/landmark_embedding.npy` |
| - `FaceAnimator-flame2bs/vertice_fit/utils/new_arkit_basis_matrix.npy` |
| - `FaceAnimator-flame2bs/vertice_fit/FLAME/geometry/generic_model.pkl`：未包含，见下方许可证说明 |
|
|
| ## 可选转换权重 |
|
|
| - `best_frame_flame2bs.pth`：离线脚本默认使用，HTTP `--f2b-model frame` 使用 |
| - `best_mlp_flame2bs.pth`：HTTP/离线 `mlp` 模式使用 |
|
|
| ## FLAME 许可证边界 |
|
|
| `generic_model.pkl` 受 FLAME 模型许可证约束，本包不包含，也不应上传至公开 Hugging Face 仓库。使用者需自行从 FLAME 官方渠道取得，并放到： |
|
|
| `FaceAnimator-flame2bs/vertice_fit/FLAME/geometry/generic_model.pkl` |
|
|
| 其正确版本的预期信息为：大小 `53023716` 字节，md5 `cfc3b95159b2a8981ebc347170202ba5`。 |
|
|
| ## 完整性校验 |
|
|
| `SHA256SUMS` 覆盖包内全部模型、配置与数值资产。Linux 下在本目录执行： |
|
|
| ```bash |
| sha256sum -c SHA256SUMS |
| ``` |
|
|
| `config.json` 仅将原始 `_name_or_path` 清理为相对名称 `chinese-hubert-base`，模型结构与权重未改动。 |
|
|
| 代码仓库不在本资产包内；对应代码分支为 `feat/a2f-service-delivery`。 |
|
|
