您希望在命令行模式(CLI)下使用自定义的API(例如翻译或TTS API)。这需要在命令行参数中指定对应的渠道类型,并在软件配置文件中预先设置好API密钥和地址。
配置API:首先,您需要在图形界面(GUI)中配置好您要使用的API。
- 打开
sp.exe(或 sp.py)。 - 进入
菜单 -> 翻译设置(或 配音设置),找到您要使用的渠道(如 OpenAI、DeepSeek、Edge-TTS API 等)。 - 在对应的设置面板中,正确填写
API URL 和 API Key,然后保存。
使用命令行:配置完成后,您可以在命令行中使用 cli.py 并指定相应的任务和渠道参数。
- 基本命令结构:
uv run cli.py --task <任务类型> --name "输入文件" [其他参数] 关键参数:
--task:指定任务类型,如 vtv(视频翻译)、stt(语音转录)、tts(字幕配音)、sts(字幕翻译)。--recogn_type:指定语音识别渠道的编号(需查阅代码或日志确定对应编号)。--translate_type:指定翻译渠道的编号。--tts_type:指定配音渠道的编号。--source_language_code:原始语言代码(如 zh)。--target_language_code:目标语言代码(如 en)。
示例命令(视频翻译,使用已配置的API):
uv run cli.py --task vtv --name "video.mp4" --source_language_code zh --target_language_code en --translate_type 5 --tts_type 3
- 此命令表示:将中文视频
video.mp4 翻译成英文,使用您在GUI中配置好的第5号翻译渠道(例如OpenAI)和第3号配音渠道(例如Edge-TTS)。
注意:--translate_type、--tts_type 等参数的具体编号,需要您通过运行软件并查看相关日志,或查阅 videotrans/translator/__init__.py 和 videotrans/tts/__init__.py 等源码文件中的渠道定义顺序来确定。更简便的方法是先在GUI中操作一次,然后在 logs 目录下的日志文件中搜索“translate_type”或“tts_type”来查看实际使用的编号。
请查阅相关文档: