PHP与Baidu_EasyDL集成_定制化AI模型调用【技巧】-php教程-PHP中文网

easydl php集成需直调rest api，动态获取30天有效期access_token，严格按multipart/form-data上传image字段，注意result结构差异、qps限流及model_id等细节校验。

php与baidu_easydl集成_定制化ai模型调用【技巧】

EasyDL SDK 的 PHP 版本兼容性问题很实际

EasyDL 官方未提供 PHP SDK，直接调用其 REST API 是唯一可靠路径。PHP 7.4+ 可用 curl 或 file_get_contents 发起请求，但要注意 EasyDL 的鉴权方式（access_token）有效期仅 30 天，且必须通过百度 AI 开放平台的 /oauth/2.0/token 接口动态获取——硬编码 access_token 会导致两天后批量失败。

常见错误现象：{"error_code":110,"error_msg":"Access token invalid or no longer valid"}

每次请求前应先检查本地缓存的 access_token 是否过期（比对 expires_in 时间戳）
建议将 client_id 和 client_secret 存在环境变量或配置文件中，避免泄露到代码库
百度返回的 access_token 是字符串，不含空格或换行，但部分开发者误用 trim() 后多删了字符，导致鉴权失败

POST 图片到 EasyDL 预测接口时的 multipart 格式要严格匹配

EasyDL 的预测接口（如 https://aip.baidubce.com/rpc/2.0/ai_custom/v1/detection/{model_id}）要求 Content-Type: multipart/form-data，且字段名必须为 image，不能是 file 或 img。PHP 的 curl 默认不自动设置 boundary，需手动构造或交由 curl_file_create() 处理。

典型错误：{"error_code":336001,"error_msg":"invalid request, image not found"}

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

PHP 5.5+ 推荐用 curl_file_create(<code>/path/to/image.jpg) 创建上传对象，再赋给 image 字段
若用 PHP 5.4 或禁用 curl_file_create，需手写 boundary，且确保 image 字段值是原始二进制内容（不是 base64），且开头结尾无多余换行
图片大小不能超过 4MB，格式限 JPG、PNG、BMP；传 WebP 会静默失败，返回空结果而非报错

解析 EasyDL 返回 JSON 时注意字段嵌套与空数组边界

EasyDL 的检测/分类接口返回结构不统一：检测模型返回 result 是数组，分类模型返回 result 是对象。且当无目标时，result 可能为 null、空数组 [] 或缺失字段，直接 foreach($res['result'] as $item) 会触发 PHP Warning。

示例安全读取方式：

$result = $res['result'] ?? [];
if (is_array($result)) {
    foreach ($result as $item) {
        echo $item['name'] ?? 'unknown';
    }
}

永远用 ?? 操作符兜底 result、score、location 等深层字段
EasyDL 的坐标字段 location 是对象（非数组），含 left、top、width、height 四个整数，不要假设它是数组索引形式
返回中的 log_id 是调试关键，出问题时需连同时间戳一起提交给百度技术支持，单说“调用失败”他们无法定位

并发调用 EasyDL 接口时容易触发频率限制

免费版 EasyDL 模型默认 QPS 为 1，即每秒最多 1 次请求。PHP 中用 foreach 批量处理图片时，若没加延迟，瞬间发 10 个请求，前 1 个成功，后 9 个全部返回 {"error_code":17,"error_msg":"Open api qps request limit reached"}。