云从科技API需先用client_id和client_secret调/v1/auth/token获取access_token（HTTPS POST，application/x-www-form-urlencoded），再以Bearer方式在Authorization头中携带该token调用图像分类接口，且image字段必须为纯净base64字符串（无data:前缀及换行符），Content-Type为application/json。
云从科技 API 鉴权失败：access_token 怎么拿？
调不通不是因为你图没传对，大概率是连第一步 /v1/auth/token 都没过。云从要求用 client_id 和 client_secret 换取短期有效的 access_token，且必须走 HTTPS POST，Content-Type: application/x-www-form-urlencoded。
-
client_id和client_secret在云从「AI开放平台」控制台 →「应用管理」里查看，不是 API Key -
access_token有效期默认 2 小时，建议缓存并加失效检查，别每次请求都重取 - 返回是 JSON，必须检查
code字段是否为0，不是就说明鉴权参数错、配额超限或服务异常
POST https://api.cloudwalk.com/v1/auth/token Content-Type: application/x-www-form-urlencoded client_id=your_client_id&client_secret=your_client_secret
传图识别接口：PHP 用 cURL 发送 base64 图像最稳
云从的图像分类接口（如 /v1/ai/image/classify）不支持直接传文件流或表单 multipart，只认 image 字段里的 base64 字符串（不含 data:image/jpeg;base64, 前缀）。
- PHP 读图后用
base64_encode(file_get_contents($path))，再用str_replace去掉换行符，否则签名会校验失败 - 必须带
Authorization: Bearer请求头，漏了直接 401 - 注意
Content-Type是application/json，不是multipart/form-data
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.cloudwalk.com/v1/ai/image/classify');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'image' => str_replace(["\n", "\r"], '', base64_encode(file_get_contents('/path/to/img.jpg'))),
'top_k' => 3
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer ' . $access_token
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
返回结果解析：别硬解 result 字段，先看 code 和 message
云从返回结构固定，但错误码藏得深。常见 code 值：0 成功，1001 token 过期，2003 图像格式不支持（只认 JPG/PNG/BMP），3001 图像太大（建议 ≤ 4MB）。
-
result是数组，每个元素含label（类别名）、score（置信度 float）、id（类别 ID） - 如果
code !== 0，message字段才是真实报错原因，比如"image format not supported"比 HTTP 状态码更准 - PHP 解析前务必用
json_last_error()检查是否解析失败——有些错误响应根本不是 JSON 格式（比如网关超时返回 HTML）
图像预处理被忽略：尺寸和色彩空间影响识别准确率
云从文档没明说，但实测发现：原始图若宽高比严重失真（如 1920×1080 裁成 200×200）、或含 ICC Profile（常见于 iPhone 拍照 PNG），会导致 score 普遍偏低甚至归为“其他”类。
立即学习“PHP免费学习笔记（深入）”；
- 用
GD或Imagick统一转为 sRGB、去除元数据、缩放到模型推荐尺寸（多数为 224×224 或 256×256） - 别依赖前端上传原图——用户手机拍的图可能带 orientation 旋转信息，PHP 读出来是歪的，识别必然错
- 测试时用云从控制台「调试工具」上传同一张图，对比你 PHP 发出去的 base64 是否和它生成的一致，这是排查传输失真的最快方式
真正卡住的往往不是代码语法，而是 token 缓存逻辑写错、base64 多了换行、图没转色域——这些细节在日志里不报错，只默默返回低分结果。
