PHP调用阿里云AI直播审核教程

阿里云直播AI审核目前不提供官方PHP SDK支持，开发者必须手动构造HTTP请求调用OpenAPI，严格遵循SHA256withRSA签名、全量Header字段（如x-acs-signature-nonce、x-acs-version等）、合规的阿里云RTMP/HTTP-FLV流地址（需在控制台开启AI审核功能），且语音检测完全依赖视频流自动提取AAC音频，不可单独提交audio_url；回调则必须使用公网可访问的HTTPS地址，正确解析raw JSON并校验X-Acs-Signature签名——签名失效或回调地址不合规，是90%以上集成失败的根本原因。

阿里云AI直播审核SDK在PHP中无法初始化 client

直接用官方 PHP SDK 初始化 AlibabaCloud\Tea\Console\Client 或 V20240115\Client 会报错，因为阿里云目前**没有发布正式支持直播审核场景的 PHP SDK**。所有文档里提到的 V20240115（对应 liveaudit 服务）仅提供 OpenAPI 规范，不带 PHP 封装类。

实操建议：

• 放弃找现成 LiveAuditClient 类，它不存在；必须手写 HTTP 请求调用 OpenAPI
• 使用 cURL 或 GuzzleHttp\Client 发送 POST 请求到 https://liveaudit.cn-shanghai.aliyuncs.com
• 签名必须用 AK/SK + SHA256withRSA 签名方式，不能用简单 access_token
• Header 中必须包含 x-acs-signature-nonce、x-acs-signature-method、x-acs-version、x-acs-action 等字段，漏一个就返回 InvalidAccessKeyId.NotFound

PHP 实时推流画面检测：如何构造合规的 video_url 参数

直播审核接口要求传入的 video_url 不是本地文件路径，也不是任意公网 URL，而是阿里云内部可拉取的流地址 —— 必须是已接入阿里云视频直播服务（ApsaraVideo Live）的 rtmp:// 或 http-flv:// 地址，且需开启「录制」或「AI 审核」功能。

常见错误现象：

• 传 https://your-domain.com/live/test.flv → 返回 InvalidParameter.VideoUrl
• 传本地 file:///tmp/stream.mp4 → 直接 400，服务端根本不会尝试读取
• 用非阿里云 CDN 的 FLV 地址 → 超时，因审核服务只信任自家边缘节点

正确做法：

• 确保流已推送到阿里云直播域名，如 rtmp://xxx.live.aliyuncs.com/app/stream
• 在控制台为该流开启「AI 内容审核」开关（路径：视频直播 → 域名管理 → 对应域名 → AI 审核）
• video_url 字段填 http-flv://xxx.live.aliyuncs.com/app/stream（注意协议和域名一致）

语音违规识别失败：PHP 提交 audio_url 后始终返回 empty result

语音审核不是独立接口，它依赖画面审核任务中自动提取的音频轨 —— 你不能单独提交一段 MP3 给直播审核 API。所谓 audio_url 参数，仅在「点播审核」场景下有效，而直播审核的语音检测是后台自动做的，无需也不允许手动指定音频源。

所以如果你看到返回里 "audio_result": [] 或缺失字段，大概率是因为：

• 推流未开启音频编码（如只推纯视频流），导致无音频轨可分析
• 音频编码格式非 AAC（阿里云只支持 AAC-LC，不支持 Opus/MP3/PCM）
• 流延迟过高（>8s），触发了音频截断策略，审核服务跳过语音部分

验证方法：用 ffprobe 检查流信息：ffprobe -v quiet -show_entries stream=codec_type,codec_name -of default rtsp://xxx，确认有 codec_type=audio 且 codec_name=aac

PHP 处理回调通知时收不到 audit_result

阿里云直播审核结果不是同步返回的，必须配置 HTTPS 回调地址，且该地址要能被阿里云外网访问。很多人本地开发时填 http://localhost:8000/callback，自然收不到任何数据。

关键条件：

• 回调地址必须是公网可访问的 HTTPS 域名（自签名证书不行，需 Let's Encrypt 或商业 CA）
• PHP 接口必须响应 200 OK，且 body 为空（不能输出任何字符，包括 BOM、空格、echo ""）
• 收到的 POST 数据是 raw JSON，不是 $_POST，要用 file_get_contents("php://input") 读取
• 必须校验 X-Acs-Signature Header，否则可能是伪造请求（签名密钥 = AK + SK + timestamp 拼接后 SHA256）

示例校验片段（简化）：

if (!isset($_SERVER['HTTP_X_ACS_SIGNATURE'])) {
    http_response_code(400);
    exit;
}
$rawBody = file_get_contents('php://input');
$expected = hash_hmac('sha256', $rawBody . $_SERVER['HTTP_X_ACS_TIMESTAMP'], $accessKeySecret);
if (!hash_equals($expected, $_SERVER['HTTP_X_ACS_SIGNATURE'])) {
    http_response_code(401);
    exit;
}

理论要掌握，实操不能落！以上关于《PHP调用阿里云AI直播审核教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！