使用MP4.to PHP API转换AV1文件为MP4失败问题排查

核心问题定位 #

从调试信息来看，调用MP4.to API时返回file_count:0和“Not Found”，偶尔返回uuid但非预期响应，核心问题大概率出在文件提交有效性或API调用参数正确性上——PHP无报错说明语法、服务器基础环境（如curl扩展）正常。

逐步排查与修复步骤 #

1. 确认文件访问权限 #

Apache运行用户（通常为www-data）必须拥有待转换文件的读取权限，否则API无法获取文件内容：

# 查看文件权限详情
ls -l /var/www/html/to_convert.mp4
# 给其他用户添加读权限
chmod o+r /var/www/html/to_convert.mp4
# 或直接将文件归属Apache用户组
chown www-data:www-data /var/www/html/to_convert.mp4

2. 修正API文件提交格式 #

MP4.to API要求用multipart/form-data格式提交文件，不能直接传绝对路径字符串，必须用PHP的CURLFile类构造参数。正确调用示例：

<?php
$apiKey = "你的API密钥"; // 替换为实际密钥
$filePath = realpath('/var/www/html/to_convert.mp4');

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.mp4.to/convert");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);

// 构造符合要求的文件上传参数
$postFields = [
    'file' => new CURLFile($filePath, 'video/mp4', 'to_convert.mp4'),
    'apikey' => $apiKey,
    'format' => 'mp4' // 指定输出为标准MP4
];
curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);

$response = curl_exec($ch);
// 调试用：打印完整响应和curl错误信息
var_dump($response);
var_dump(curl_error($ch));
curl_close($ch);
?>

3. 验证API密钥与接口端点 #

• 确认API密钥有效（未过期、额度充足）
• 确保调用的接口端点为官方指定的转换接口，不要使用错误的域名或路径

4. 处理异步返回的uuid #

如果返回uuid，说明API已接收文件，需通过状态查询接口轮询转换进度：

<?php
$uuid = "接口返回的uuid";
$apiKey = "你的API密钥";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.mp4.to/status?uuid={$uuid}&apikey={$apiKey}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$statusResponse = curl_exec($ch);
var_dump($statusResponse);
curl_close($ch);
?>

MP4.to API采用异步处理机制，无法一次调用直接获取转换后的文件，需等待状态返回“完成”后再获取下载链接。

额外调试技巧 #

• 开启PHP错误日志：在php.ini中设置error_log = /var/log/php_errors.log，捕获隐藏警告（如CURLFile初始化失败）
• 用Postman手动测试API：直接上传待转换文件，确认API能正常响应，排除代码之外的问题

内容的提问来源于stack exchange，提问作者user25476863