EasyDL PHP集成需直调REST API，动态获取30天有效期access_token，严格按multipart/form-data上传image字段，注意result结构差异、QPS限流及model_id等细节校验。
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"}
立即学习“PHP免费学习笔记（深入）”；
- 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"}。
- 生产环境务必加
usleep(1000000)（1 秒）间隔，或改用队列（如 Redis + crontab）削峰 - 百度的 QPS 统计是按
access_token维度，不是按 IP 或 AppID，多个服务共用同一 token 会互相挤占配额 - 如需更高 QPS，必须在 EasyDL 控制台申请“高并发调用”，审核通过后才生效，不是开通服务就自动提升
model_id 是否复制完整（它含字母和数字共 32 位）、access_token 是否被意外截断、以及图片路径是否真能被 PHP 进程读取——这些地方没有报错提示，只有空响应。 
