CLI 参数

配置路径 ⁿᵉˣᵗ

选择配置文件来覆盖默认值。

争论：-c/--config-path

默认：facefusion.ini

例子：--config-path facefusion.ini

源路径 ⁿᵉˣᵗ

选择单个或多个源图像或音频。

争论：-s/--source-paths

默认：None

例子：--source-paths source.jpg source.mp3

目标路径 ⁿᵉˣᵗ

选择单个目标图像或视频。

争论：-t/--target-path

默认：None

例子：--target-path target.mp4

输出路径 ⁿᵉˣᵗ

指定目录内的输出图像或视频。

争论：-o/--output-path

默认：None

例子：--output-path output.mp4

工作路径 ⁿᵉˣᵗ

指定存储作业的目录

争论：-j/--jobs-path

默认：.jobs

例子：--jobs-path .jobs

默认覆盖

修改facefusion.ini文件以覆盖默认值。

[general]

source_paths = source.jpg source.mp3

target_path = target.mp4

output_path = output.mp4

jobs_path = .jobs

强制下载

强制自动下载并退出。

争论：--force-download

默认：None

例子：--force-download

跳过下载

省略自动下载和远程查找。

争论：--skip-download

默认：None

例子：--skip-download

无头

运行不带用户界面的程序。

争论：--headless

默认：None

例子：--headless

日志级别

调整终端显示的消息严重性。

争论：--log-level

默认：info

选择：error warn info debug

例子：--log-level debug

默认覆盖

修改facefusion.ini文件以覆盖默认值。

[misc]

force_download = True

skip_download = True

headless = True

log_level = debug

执行设备 ID

指定用于处理的设备。

争论：--execution-device-id

默认：0

例子：--execution-device-id 1

执行提供商

使用不同的提供程序加速模型推理。

争论：--execution-providers

默认：cpu

例子：--execution-providers cuda

执行线程数

指定处理时的并行线程数量。

争论--execution-thread-count

默认：1

范围：1至1281

例子：--execution-thread-count 32

执行队列计数

指定每个线程处理的帧数量。

争论--execution-queue-count

默认：1

范围：1至321

例子：--execution-queue-count 2

默认覆盖

修改facefusion.ini文件以覆盖默认值。

[execution]

execution_device_id = 1

execution_providers = cuda

execution_thread_count = 32

execution_queue_count = 2

影像记忆策略

平衡快速帧处理和低 VRAM 使用率。

争论：--video-memory-strategy

默认：strict

选择：strict moderate tolerant

例子：--video-memory-strategy tolerant

系统内存限制

限制处理时可使用的 RAM。

争论：--system-memory-limit

默认：0

范围：0至1284

例子：--system-memory-limit 16

默认覆盖

修改facefusion.ini文件以覆盖默认值。

[memory]

video_memory_strategy = tolerant

system_memory_limit = 16

人脸检测模型 ⁿᵉˣᵗ

选择负责检测面部的模型。

争论：--face-detector-model

默认：yoloface

选择：many retinaface scrfd yoloface

例子：--face-detector-model retinaface

人脸检测器角度

指定检测人脸之前旋转框架的角度。

争论：--face-detector-angles

默认：0

选择：0 90 180 270

例子：--face-detector-angles 0 180

人脸检测器尺寸

指定提供给人脸检测器的框架的大小。

争论：--face-detector-size

默认：640x640

选择：160x160 320x320 480x480 512x512 640x640 768x768 960x960 1024x1024

例子：--face-detector-size 320x320

人脸检测器得分

根据置信度得分过滤检测到的面部。

争论：--face-detector-score

默认：0.5

范围：0至10.05

例子：--face-detector-score 0.7

面部标志得分

根据置信度得分过滤检测到的地标。

争论：--face-landmarker-score

默认：0.5

范围：0至10.05

例子：--face-landmarker-score 0.7

默认覆盖 ⁿᵉˣᵗ

修改facefusion.ini文件以覆盖默认值。

[face_analyser]

face_detector_model = yoloface

face_detector_angles = 0 180

face_detector_size = 320x320

face_detector_score = 0.7

face_landmarker_score = 0.7

面部选择器模式

使用基于参考的跟踪或简单匹配。

争论：--face-selector-mode

默认：reference

选择：many one reference

例子：--face-selector-mode one

脸部选择器顺序 ⁿᵉˣᵗ

指定人脸分析器检测人脸的顺序。

争论：--face-selector-order

默认：left-right

选择：left-right right-left top-bottom bottom-top small-large large-small best-worst worst-best

例子：--face-selector-order best-worst

脸部选择器年龄 ⁿᵉˣᵗ

根据年龄过滤检测到的面部。

争论：--face-selector-age

默认：None

选择：child teen adult senior

例子：--face-selector-age adult

脸部选择器性别 ⁿᵉˣᵗ

根据性别过滤检测到的面孔。

争论：--face-selector-gender

默认：None

选择：male female

例子：--face-selector-gender male

参考面部位置

指定用于创建参考面的位置。

争论：--reference-face-position

默认：0

例子：--reference-face-position 1

参考面距离

指定参考面和目标面之间所需的相似度。

争论：--reference-face-distance

默认：0.6

范围：0至1.50.05

例子：--reference-face-distance 0.8

参考帧编号

指定用于创建参考面的框架。

争论：--reference-frame-number

默认：0

例子：--reference-frame-number 100

默认覆盖 ⁿᵉˣᵗ

修改facefusion.ini文件以覆盖默认值。

[face_selector]

face_selector_mode = one

face_selector_order = best-worst

face_selector_age = adult

face_selector_gender = male

reference_face_position = 1

reference_face_distance = 0.8

reference_frame_number = 100

面膜类型

混合搭配不同类型的面膜。

争论：--face-mask-types

默认：box

选择：box occlusion region

例子：--face-mask-types box occlusion

面罩模糊

指定应用框蒙版的模糊程度。

争论：--face-mask-blur

默认：0.3

范围：0至10.05

例子：--face-mask-blur 0.6

面罩衬垫

对盒子蒙版应用顶部、右侧、底部和左侧填充。

争论：--face-mask-padding

默认：0 0 0 0

例子：--face-mask-padding 1 2

面膜区域

选择用于区域蒙版的面部特征。

争论：--face-mask-regions

默认：All

选择：skin left-eyebrow right-eyebrow left-eye right-eye glasses nose mouth upper-lip lower-lip

例子：--face-mask-regions left-eye right-eye eye-glasses

默认覆盖 ⁿᵉˣᵗ

修改facefusion.ini文件以覆盖默认值。

[face_masker]

face_mask_types = box occlusion

face_mask_blur = 0.6

face_mask_padding = 1 2

face_mask_regions = left-eye right-eye glasses

修剪帧开始

指定目标视频的起始帧。

争论：--trim-frame-start

默认：None

例子：--trim-frame-start 100

修剪框架末端

指定目标视频的结束帧。

争论：--trim-frame-end

默认：None

例子：--trim-frame-end 200

临时帧格式

指定临时资源格式。

争论：--temp-frame-format

默认：png

选择：bmp jpg png

例子：--temp-frame-format bmp

保持温度

处理后保留临时资源。

争论：--keep-temp

默认：None

例子：--keep-temp

默认覆盖

修改facefusion.ini文件以覆盖默认值。

[frame_extraction]

trim_frame_start = 100

trim_frame_end = 200

temp_frame_format = bmp

keep_temp = True

输出图像质量

指定转换为压缩因子的图像质量。

争论：--output-image-quality

默认：80

范围：0至1001

例子：--output-image-quality 60

输出图像分辨率

根据目标图像指定图像输出分辨率。

争论：--output-image-resolution

默认：None

例子：--output-image-resolution 1920x1080

输出音频编码器 ⁿᵉˣᵗ

指定用于音频输出的编码器。

争论：--output-audio-encoder

默认：aac

选择：aac libmp3lame libopus libvorbis

例子：--output-audio-encoder libvorbis

输出视频编码器

指定用于视频输出的编码器。

争论：--output-video-encoder

默认：libx264

选择：libx264 libx265 libvpx-vp9 h264_nvenc hevc_nvenc h264_amf hevc_amf

例子：--output-video-encoder libx265

输出视频预设

平衡快速视频处理和视频文件大小。

争论：--output-video-preset

默认：veryfast

选择：ultrafast superfast veryfast faster fast medium slow slower veryslow

例子：--output-video-preset ultrafast

输出视频质量

指定转换为压缩系数的视频质量。

争论：--output-video-quality

默认：80

范围：0至1001

例子：--output-video-quality 60

输出视频分辨率

根据目标视频指定视频输出分辨率。

争论：--output-video-resolution

默认：None

例子：--output-video-resolution 1920x1080

输出视频帧率

根据目标视频指定视频输出 fps。

争论：--output-video-fps

默认：None

范围：1至60

例子：--output-video-fps 30

跳过音频

省略目标视频中的音频。

争论：--skip-audio

默认：None

例子：--skip-audio

[output_creation]

output_image_quality = 60

output_image_resolution = 1920x1080

output_audio_encoder = libvorbis

output_video_encoder = libx265

output_video_preset = ultrafast

output_video_quality = 60

output_video_resolution = 1920x1080

output_video_fps = 30

skip_audio = True

帧处理器

加载一个或多个帧处理器。

争论：--frame-processors

默认：face_swapper

选择：age-modifier face_debugger face_enhancer face_swapper frame_colorizer frame_enhancer lip_syncer

例子：--frame-processors face_swapper face_enhancer

年龄修正模型 ⁿᵉˣᵗ

选择负责面部老化的模型。

争论：--age-modifier-model

默认：styleganex_age

选择：styleganex_age

例子：--age-modifier-model styleganex_age

年龄修正方向 ⁿᵉˣᵗ

指定应修改年龄的方向。

争论：--age-modifier-direction

默认：0

范围：-100至1001

例子：--age-modifier-direction 100

面部调试器项目

可视化人脸检测器和人脸遮罩相关项目。

争论：--face-debugger-items

默认：face-landmark-5/68 face-mask

选择：bounding-box face-landmark-5 face-landmark-5/68 face-landmark-68 face-landmark-68/5 face-mask face-detector-score face-landmarker-score age-gender

例子：--face-debugger-items bounding-box face-detector-score

面部增强模型

选择负责增强脸部的模型。

争论：--face-enhancer-model

默认：gfpgan_1.4

选择：codeformer gfpgan_1.2 gfpgan_1.3 gfpgan_1.4 gpen_bfr_256 gpen_bfr_512 gpen_bfr_1024 gpen_bfr_2048 restoreformer_plus_plus

例子：--face-enhancer-model codeformer

面部增强剂混合物

将增强部分与之前的面容混合。

争论：--face-enhancer-blend

默认：80

范围：0至1001

例子：--face-enhancer-blend 60

换脸模特 ⁿᵉˣᵗ

选择负责换脸的模型。

争论：--face-swapper-model

默认：inswapper_128_fp16

选择：blendswap_256 ghost_256_unet_1 ghost_256_unet_2 ghost_256_unet_3 inswapper_128 inswapper_128_fp16 simswap_256 simswap_512_unofficial uniface_256

例子：--face-swapper-model simswap_256

换脸器 Pixel Boost ⁿᵉˣᵗ

为脸部交换器选择像素增强分辨率。

争论：--face-swapper-pixel-boost

默认：128x128

选择：128x128 256x256 384x384 512x512 768x768 1024x1024

例子：--face-swapper-pixel-boost 512x512

帧着色器模型

选择负责为框架着色的模型。

争论：--frame-colorizer-model

默认：ddcolor

选择：ddcolor ddcolor_artistic deoldify deoldify_artistic deoldify_stable

例子：--frame-enhancer-model deoldify

框架着色器混合

将彩色图像混合到前一帧中。

争论：--frame-colorizer-blend

默认：100

范围：0至1001

例子：--frame-colorizer-blend 80

框架着色器尺寸

指定提供给框架着色器的框架的大小。

争论：--frame-colorizer-size

默认：256x256

选择：256x256 384x384 512x512

例子：--frame-colorizer-size 512

框架增强器模型

选择负责增强框架的模型。

争论：--frame-enhancer-model

默认：span_kendata_x4

选择：lsdir_x4 nomos8k_sc_x4 real_esrgan_x2 real_esrgan_x2_fp16 real_esrgan_x4 real_esrgan_x4_fp16 real_hatgan_x4 span_kendata_x4

例子：--frame-enhancer-model real_hatgan_x4

框架增强剂混合物

将增强的内容混合到前一帧中。

争论：--frame-enhancer-blend

默认：80

范围：0至1001

例子：--frame-enhancer-blend 60

口型同步模型

选择负责同步嘴唇的模型。

争论：--lip-syncer-model

默认：wave2lip_gan

选择：wave2lip_gan

例子：--lip-syncer-model wave2lip_gan

默认覆盖

修改facefusion.ini文件以覆盖默认值。

[frame_processors]

frame_processors = face_swapper face_enhancer

age_modifier_model = styleganex_age

age_modifier_direction = 100

face_debugger_items = bounding-box face-detector-score

face_enhancer_model = codeformer

face_enhancer_blend = 60

face_swapper_model = simswap_256

face_swapper_pixel_boost = 512x512

frame_colorizer_model = deoldify

frame_colorizer_blend = 80

frame_colorizer_size = 512

frame_enhancer_model = real_hatgan_x4

frame_enhancer_blend = 60

lip_syncer_model = wave2lip_gan

打开浏览器

程序准备就绪后，打开浏览器。

争论：--open-browser

默认：None

例子：--open-browser

UI 布局

启动一个或多个 UI 布局。

争论：--ui-layouts

默认：default

选择：benchmark default webcam

例子：--ui-layouts benchmark

默认覆盖

修改facefusion.ini文件以覆盖默认值。

[uis]

open_browser = True

ui_layouts = benchmark

创建工作 ⁿᵉˣᵗ

创建一份草稿作业。

争论：--job-create

默认：None

例子：--job-create example

提交工作 ⁿᵉˣᵗ

提交草稿作业以使其成为排队作业。

争论：--job-submit

默认：None

例子：--job-submit example

提交全部职位 ⁿᵉˣᵗ

提交所有草稿作业以使其成为排队作业。

争论：--job-submit-all

默认：None

例子：--job-submit-all

删除工作 ⁿᵉˣᵗ

删除草稿、排队、失败或已完成的作业。

争论：--job-delete

默认：None

例子：--job-delete example

删除全部职位 ⁿᵉˣᵗ

删除所有起草的、排队的、失败的和已完成的作业。

争论：--job-delete-all

默认：None

例子：--job-delete-all

工作列表 ⁿᵉˣᵗ

按状态列出工作。

争论：--job-list

默认：None

选择：drafted queued completed failed

例子：--job-list queued

工作添加步骤 ⁿᵉˣᵗ

向起草的作业添加一个步骤。

争论：--job-add-step

默认：None

例子：--job-add-step example -s source.jpg -t target.mp4 -o output.mp4

Job Remix Step ⁿᵉˣᵗ

重新混合草稿作业中的先前步骤。

争论：--job-remix-step

默认：None

例子：--job-remix-step example 0 -s source.jpg -o output.mp4

工作插入步骤 ⁿᵉˣᵗ

向起草的作业中插入一个步骤。

争论：--job-insert-step

默认：None

例子：--job-insert-step example 0 -s source.jpg -t target.mp4 -o output.mp4

作业删除步骤 ⁿᵉˣᵗ

从起草的作业中删除一个步骤。

争论：--job-remove-step

默认：None

例子：--job-remove-step example 0

工作运行 ⁿᵉˣᵗ

运行排队作业。

争论：--job-run

默认：None

例子：--job-run example --execution-provider cuda

全部运行作业 ⁿᵉˣᵗ

运行所有排队的作业。

争论：--job-run-all

默认：None

例子：--job-run-all --execution-provider cuda

重试作业 ⁿᵉˣᵗ

重试失败的作业。

争论：--job-retry

默认：None

例子：--job-retry example --execution-provider cuda

重试全部任务 ⁿᵉˣᵗ

重试所有失败的作业。

争论：--job-retry-all

默认：None

例子：--job-retry-all --execution-provider cuda