在本快速入门中,你将使用计算机视觉的 REST API 分析远程存储的图像以提取视觉特征。 使用分析图像方法,可以根据图像内容提取视觉特征。
如果没有 Azure 订阅,可在开始前创建一个试用帐户。
先决条件
创建并运行示例
要创建和运行示例,请执行以下步骤:
安装 PHP5
HTTP_Request2
包。以管理员身份打开命令提示符窗口。
运行以下命令:
pear install HTTP_Request2
包安装成功后,关闭命令提示符窗口。
将以下代码复制到文本编辑器中。
必要时在代码中进行如下更改:
- 将
subscriptionKey
的值替换为你的订阅密钥。 - 如有必要,请将
uriBase
的值替换为获取的订阅密钥所在的 Azure 区域中的分析图像方法的终结点 URL。 - (可选)将
imageUrl
的值替换为要分析的其他图像的 URL。 - (可选)将
language
请求参数的值替换为其他语言。
- 将
将代码保存为以
.php
为扩展名的文件。 例如,analyze-image.php
。打开具有 PHP 支持的浏览器窗口。
将文件拖放到浏览器窗口中。
<html>
<head>
<title>Analyze Image Sample</title>
</head>
<body>
<?php
// Replace <Subscription Key> with a valid subscription key.
$ocpApimSubscriptionKey = '<Subscription Key>';
$uriBase = 'https://api.cognitive.azure.cn/vision/v2.0/';
$imageUrl = 'https://upload.wikimedia.org/wikipedia/commons/3/3c/Shaki_waterfall.jpg';
require_once 'HTTP/Request2.php';
$request = new Http_Request2($uriBase . '/analyze');
$url = $request->getUrl();
$headers = array(
// Request headers
'Content-Type' => 'application/json',
'Ocp-Apim-Subscription-Key' => $ocpApimSubscriptionKey
);
$request->setHeader($headers);
$parameters = array(
// Request parameters
'visualFeatures' => 'Categories,Description',
'details' => '',
'language' => 'en'
);
$url->setQueryVariables($parameters);
$request->setMethod(HTTP_Request2::METHOD_POST);
// Request body parameters
$body = json_encode(array('url' => $imageUrl));
// Request body
$request->setBody($body);
try
{
$response = $request->send();
echo "<pre>" .
json_encode(json_decode($response->getBody()), JSON_PRETTY_PRINT) . "</pre>";
}
catch (HttpException $ex)
{
echo "<pre>" . $ex . "</pre>";
}
?>
</body>
</html>
检查响应
成功的响应以 JSON 格式返回。 示例网站会在浏览器窗口中分析和显示成功响应,如下例所示:
{
"categories": [
{
"name": "outdoor_water",
"score": 0.9921875,
"detail": {
"landmarks": []
}
}
],
"description": {
"tags": [
"nature",
"water",
"waterfall",
"outdoor",
"rock",
"mountain",
"rocky",
"grass",
"hill",
"covered",
"hillside",
"standing",
"side",
"group",
"walking",
"white",
"man",
"large",
"snow",
"grazing",
"forest",
"slope",
"herd",
"river",
"giraffe",
"field"
],
"captions": [
{
"text": "a large waterfall over a rocky cliff",
"confidence": 0.916458423253597
}
]
},
"requestId": "ebf5a1bc-3ba2-4c56-99b4-bbd20ba28705",
"metadata": {
"height": 959,
"width": 1280,
"format": "Jpeg"
}
}
清理资源
不再需要文件时,请将其删除,然后卸载 PHP5 HTTP_Request2
包。 要卸载包,请执行以下步骤:
以管理员身份打开命令提示符窗口。
运行以下命令:
pear uninstall HTTP_Request2
成功卸载包后,关闭命令提示符窗口。
后续步骤
了解计算机视觉 API,它用于分析图像、检测名人和地标、创建缩略图,并提取印刷体文本和手写文本。 要快速体验计算机视觉 API,请尝试使用 Open API 测试控制台。