用 PHP 和 Whisper API 实现语音转文字的在线字幕生成器-php教程-PHP中文网

srt字幕需将whisper api返回的秒级浮点时间戳转换为hh:mm:ss,mmm格式，正确做法是先round($t*1000)取整毫秒，再拆解时分秒毫秒，避免用date()误当unix时间戳处理。

用 php 和 whisper api 实现语音转文字的在线字幕生成器

Whisper API 返回的 timestamped segments 怎么解析成 SRT 字幕格式

Whisper API（OpenAI 官方接口）返回的 segments 是带起止时间戳的数组，但时间单位是秒（浮点数），而 SRT 要求 HH:MM:SS,mmm 格式。直接四舍五入或 date() 会出错——因为 date('H:i:s', $seconds) 把秒数当 Unix 时间戳处理，导致乱码。

正确做法是手动拆解：用 floor($t) 得总秒数，再分别算时、分、秒、毫秒：

function secondsToSrtTime(float $t): string {
    $totalMs = (int)round($t * 1000);
    $hours = floor($totalMs / 3600000);
    $minutes = floor(($totalMs % 3600000) / 60000);
    $seconds = floor(($totalMs % 60000) / 1000);
    $ms = $totalMs % 1000;
    return sprintf('%02d:%02d:%02d,%03d', $hours, $minutes, $seconds, $ms);
}

必须用 round($t * 1000) 再取整，避免浮点误差（如 12.999 变成 12,998）
API 返回的 segments 中 start 和 end 是 float，别直接传给 date()
如果后端用 PHP 8.1+，可用 str_pad() 替代 sprintf，但 sprintf 更稳

PHP cURL 调用 Whisper API 时怎么传音频文件且不超时

Whisper API 要求 multipart/form-data 提交 file（二进制音频）和 model（如 "whisper-1"），不能用 JSON body。常见错误是用 json_encode() 包裹文件内容，结果返回 400 Bad Request: Invalid file。

关键点：用 CURLFile（PHP 5.5+）构造上传体，禁用 @ 语法（已被弃用且在 PHP 8.0+ 报错）：

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.openai.com/v1/audio/transcriptions',
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => [
        'file' => new CURLFile('/tmp/upload.wav', 'audio/wav', 'audio.wav'),
        'model' => 'whisper-1',
        'response_format' => 'verbose_json', // 必须设这个才能拿到 segments
        'timestamp_granularities[]' => 'segment'
    ],
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $_ENV['OPENAI_API_KEY'],
        'Content-Type: multipart/form-data'
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 300 // Whisper 处理长音频可能超 60 秒，至少设 300
]);