Whisper.cpp服务器请求参数配置指南

Whisper.cpp作为一款开源的语音识别工具，其内置的服务器功能为开发者提供了便捷的API接口。本文将详细介绍如何通过curl命令向Whisper.cpp服务器发送请求并配置各种参数。

核心请求参数

Whisper.cpp服务器支持多种参数配置，这些参数主要通过multipart/form-data格式的HTTP请求传递：

1. 文件参数(file)：必须参数，指定要识别的音频文件路径
2. 温度参数(temperature)：控制模型输出的随机性，默认值为0.0
3. 温度增量(temperature_inc)：温度参数的增量值，默认0.2
4. 响应格式(response_format)：指定返回结果的格式，支持json等格式
5. 语言参数(language)：指定识别语言，如"fr"表示法语

正确请求示例

以下是向本地运行的Whisper.cpp服务器发送请求的标准格式：

curl 127.0.0.1:8080/inference \
    -H "Content-Type: multipart/form-data" \
    -F file="@audio.wav" \
    -F temperature="0.0" \
    -F temperature_inc="0.2" \
    -F response_format="json" \
    -F language="fr"

参数使用说明

1. 温度参数：值越高结果越随机，适合创造性任务；值越低结果越确定，适合精确转录

2. 语言参数：虽然Whisper支持自动检测语言，但明确指定语言参数可以提高识别准确率

3. 文件格式：支持常见音频格式如WAV、MP3等，建议使用16kHz采样率的单声道音频以获得最佳效果

常见问题解决

如果遇到参数不生效的情况，请检查：

1. 参数名称拼写是否正确（注意是language而非-l）
2. 参数值是否在有效范围内
3. 服务器是否已正确启动并监听指定端口

通过合理配置这些参数，开发者可以充分利用Whisper.cpp的强大语音识别能力，构建各种语音处理应用。