PHP如何调用云从科技AI_传图像数据调识别模型得分类【精解】

2026-01-13

PHP如何调用云从科技AI_传图像数据调识别模型得分类【精解】

云从科技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。

php如何调用云从科技ai_传图像数据调识别模型得分类【精解】

云从科技 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）