不支持。黑芝麻智能官方未提供PHP SDK，PHP调用需自行封装HTTP请求，严格满足JWT鉴权、内网IP直连、base64编码H.264帧、JSON格式含model_id/data/timestamp_ms等硬性条件。

黑芝麻智能 API 文档是否支持 PHP 直接调用？

不支持。黑芝麻智能（BWM）目前公开的 AI 模型服务（如 adas-inference、vision-model-v2）仅提供 C++ SDK、ROS 节点、以及基于 HTTP 的 /v1/inference 接口（需内网授权 + JWT 鉴权），官方未发布 PHP SDK 或 Composer 包。

这意味着你无法用 composer require heima-zhima/ai 这类方式集成——所有 PHP 层调用，本质是封装 HTTP 请求，而非原生绑定。

PHP 调用黑芝麻车载模型必须满足哪几个硬性条件？

缺一不可，否则 401/403/timeout 必现：

• Authorization 请求头必须携带有效 JWT token，由黑芝麻提供的 auth-server 签发（非你自己用 firebase/php-jwt 伪造）
• 请求地址必须是车端部署的黑芝麻推理服务 IP+端口（例如 https://www.php.cn/link/21ad1ab81ab86bc1f0a28494155ca096），不是公网域名
• 上传的车载数据格式必须严格匹配模型输入规范：通常是 base64 编码的 H.264 帧或裁剪后的 uint8 图像数组（非 JPEG 文件流）
• POST body 必须为 application/json，且含 model_id（如 "a1000-adas-lane"）、data（base64 字符串）、timestamp_ms（毫秒级时间戳）字段

PHP 中如何安全构造并发送符合要求的 inference 请求？

别用 file_get_contents() 或简单 cURL —— 容易漏掉 header、超时、SSL 验证或 base64 边界问题。推荐用 Guzzle（v7+），并做如下处理：

Cursor Directory

专为Cursor设计的开源资源库、提示词库

下载

立即学习“PHP免费学习笔记（深入）”；

use GuzzleHttp/Client;
use GuzzleHttp/Exception/RequestException;
$client = new Client([
'timeout' => 5.0,
'verify'  => false, // 车端 HTTPS 证书通常自签，需关校验
]);
try {
$response = $client->post('https://www.php.cn/link/21ad1ab81ab86bc1f0a28494155ca096', [
'headers' => [
'Authorization' => 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.xxx',
'Content-Type'  => 'application/json',
],
'json' => [
'model_id'     => 'a1000-adas-lane',
'data'         => base64_encode($raw_h264_frame), // 注意：不是 file_get_contents($jpg)
'timestamp_ms' => round(microtime(true) * 1000),
]
]);
$result = json_decode($response->getBody()->getContents(), true);
// 成功时 $result['status'] === 'success'，输出在 $result['output'] 中
} catch (RequestException $e) {

error_log('BWM API error: ' . $e->getMessage());

}
为什么车载环境下 PHP 调用容易失败？关键避坑点
不是代码写错，而是环境链路太脆：

车机 Linux 系统通常禁用 DNS，PHP 的 curl 会卡在解析阶段 → 改用 IP 直连，别写 https://bwm-infer.local

黑芝麻模型对帧率敏感，PHP 单次请求耗时若 >200ms（常见于未预热的 OPcache 或大图 base64），会导致推理队列积压 → 必须启用 opcache.enable=1 并预加载核心文件
车载摄像头输出的是 YUV420SP（NV21）原始帧，直接 base64_encode(file_get_contents()) 会传错格式 → 需先用 ffmpeg 转成 H.264 Annex-B 格式裸流，再读取二进制
JWT token 有效期默认 2 小时，PHP 进程长驻时不会自动刷新 → 必须实现 token 缓存 + 到期前 5 分钟主动调 /v1/auth/refresh 换新

真正难的从来不是写几行 PHP，而是让 PHP 在车规级延时、无 DNS、低内存、只读文件系统里，稳定喂饱黑芝麻的硬件加速推理单元。
https://www.php.cn/faq/1989985.html