Microsoft 认知操作

Azure 认知服务使您能够使用人工智能加速决策制定,而不需要机器学习专业知识。

重要提示

Azure 将于 2024 年 2 月 29 日停用Azure Cognitive Services Text Analytics v2.x。 此库由 Microsoft 认知文本分析操作使用。 在 2024 年 2 月 29 日之后,桌面流将不再支持这些操作,并且这些操作将无法运行。

桌面流提供了多种 Microsoft 认知操作,您可以将此功能集成到您的桌面流中。 文本分析、计算机视觉和拼写检查都是 Microsoft 认知操作可以执行的任务。

所有 Microsoft 认知操作都需要一个订阅密钥来验证您对某个服务或一组服务的订阅。 对于您创建的每个资源,密钥在 Azure 门户中都可用。

“拼写检查”操作的屏幕截图。

拼写检查

调用名为“必应拼写检查”的 Microsoft 认知服务

输入参数

参数 可选 接受 默认值 说明
Subscription key 文本值 要用于此 API 调用的订阅密钥
Text 文本值列表 要发送的文本或文本列表
Mode 文本值 指定拼写检查模式
Mkt 文本值 对于校验模式,仅支持以下语言代码:en-us、es-es、pt-br。 对于拼写模式,支持所有语言代码
Timeout 数值 30 代理在与服务器建立连接失败之前应等待的时间(秒)

生成的变量

参数 类型​​ 说明
JSONResponse 自定义对象 API 响应结果
StatusCode 数值 返回的状态代码

异常

例外 描述
请求已超时 指示在执行请求时已超时
无法调用认知服务 指示在尝试调用认知服务时出现问题

分析图像

调用名为“分析图像”的 Microsoft 认知服务

输入参数

参数 可选 接受 默认值 说明
Server location 不适用 美国西部、美国西部 2、美国东部、美国东部 2、美国中西部、美国中南部、欧洲西部、欧洲北部、亚洲东南部、亚洲东部、澳大利亚东部、巴西南部、加拿大中部、印度中部、英国南部、日本东部 美国西部 要用于此 API 调用的服务器位置
Subscription key 文本值 要用于此 API 调用的订阅密钥
Provide image 不适用 从文件、从 GCS 从文件 指定将通过完整路径还是 URL 地址提供图像
Image file 文件 要传输的图像文件的完整路径(文件夹加文件名)
Image URL 文本值 图像的 URL 地址
Visual features 文本值 一个文本值,指示要返回的视觉对象特征类型。 多个值应采用逗号分隔。 例如:类别、标记、说明
Details 文本值 一个文本值,指示要返回的特定于域的详细信息。 多个值应采用逗号分隔
Language 文本值 一个文本值,指示要返回的语言。 服务将以指定的语言返回识别结果
Timeout 数值 30 代理在与服务器建立连接失败之前应等待的时间(秒)

生成的变量

参数 类型​​ 说明
JSONResponse 自定义对象 API 响应结果
StatusCode 数值 返回的状态代码

异常

例外 描述
请求已超时 指示在执行请求时已超时
无法调用认知服务 指示在尝试调用认知服务时出现问题

说明图像

调用名为“描述图像”的 Microsoft 认知服务

输入参数

参数 可选 接受 默认值 说明
Server location 不适用 美国西部、美国西部 2、美国东部、美国东部 2、美国中西部、美国中南部、欧洲西部、欧洲北部、亚洲东南部、亚洲东部、澳大利亚东部、巴西南部、加拿大中部、印度中部、英国南部、日本东部 美国西部 要用于此 API 调用的服务器位置
Subscription key 文本值 要用于此 API 调用的订阅密钥
Provide image 不适用 从文件、从 GCS 从文件 指定将通过完整路径还是 URL 地址提供图像
Image file 文件 要传输的图像文件的完整路径(文件夹加文件名)
Image URL 文本值 图像的 URL 地址
Max candidates 文本值 要返回的候选项说明的最大数量。 默认值为 1
Timeout 数值 30 代理在与服务器建立连接失败之前应等待的时间(秒)

生成的变量

参数 类型​​ 说明
JSONResponse 自定义对象 API 响应结果
StatusCode 数值 返回的状态代码

异常

例外 描述
请求已超时 指示在执行请求时已超时
无法调用认知服务 指示在尝试调用认知服务时出现问题

OCR

调用名为“OCR”的 Microsoft 认知服务

输入参数

参数 可选 接受 默认值 说明
Server location 不适用 美国西部、美国西部 2、美国东部、美国东部 2、美国中西部、美国中南部、欧洲西部、欧洲北部、亚洲东南部、亚洲东部、澳大利亚东部、巴西南部、加拿大中部、印度中部、英国南部、日本东部 美国西部 要用于此 API 调用的服务器位置
Subscription key 文本值 要用于此 API 调用的订阅密钥
Provide image 不适用 从文件、从 GCS 从文件 指定将通过完整路径还是 URL 地址提供图像
Image file 文件 要传输的图像文件的完整路径(文件夹加文件名)
Image URL 文本值 图像的 URL 地址
Language 文本值 要在图像中检测的文本的 BCP-47 语言代码
Detect orientation 文本值 指定是否在图像中检测文本方向
Timeout 数值 30 代理在与服务器建立连接失败之前应等待的时间(秒)

生成的变量

参数 类型​​ 说明
JSONResponse 自定义对象 API 响应结果
StatusCode 数值 返回的状态代码

异常

例外 描述
请求已超时 指示在执行请求时已超时
无法调用认知服务 指示在尝试调用认知服务时出现问题

标记图像

调用名为“标记图像”的 Microsoft 认知服务

输入参数

参数 可选 接受 默认值 说明
Server location 不适用 美国西部、美国西部 2、美国东部、美国东部 2、美国中西部、美国中南部、欧洲西部、欧洲北部、亚洲东南部、亚洲东部、澳大利亚东部、巴西南部、加拿大中部、印度中部、英国南部、日本东部 美国西部 要用于此 API 调用的服务器位置
Subscription key 文本值 要用于此 API 调用的订阅密钥
Provide image 不适用 从文件、从 GCS 从文件 指定将通过完整路径还是 URL 地址提供图像
Image file 文件 要传输的图像文件的完整路径(文件夹加文件名)
Image URL 文本值 图像的 URL 地址
Timeout 数值 30 代理在与服务器建立连接失败之前应等待的时间(秒)

生成的变量

参数 类型​​ 说明
JSONResponse 自定义对象 API 响应结果
StatusCode 数值 返回的状态代码

异常

例外 描述
请求已超时 指示在执行请求时已超时
无法调用认知服务 指示在尝试调用认知服务时出现问题

检测语言

调用名为“文本分析 - 检测语言”的 Microsoft 认知服务。

输入参数

参数 可选 接受 默认值 说明
Server location 不适用 美国西部、美国西部 2、美国东部、美国东部 2、美国中西部、美国中南部、欧洲西部、欧洲北部、亚洲东南部、亚洲东部、澳大利亚东部、巴西南部、加拿大中部、印度中部、英国南部、日本东部 美国西部 要用于此 API 调用的服务器位置
Subscription key 文本值 要用于此 API 调用的订阅密钥
Text 文本值 要分析的文本
Timeout 数值 30 代理在与服务器建立连接失败之前应等待的时间(秒)

生成的变量

参数 类型​​ 说明
JSONResponse 自定义对象 API 响应结果
StatusCode 数值 返回的状态代码

异常

例外 描述
请求已超时 指示在执行请求时已超时
无法调用认知服务 指示在尝试调用认知服务时出现问题

关键短语

调用名为“文本分析 - 关键短语”的 Microsoft 认知服务。

输入参数

参数 可选 接受 默认值 说明
Server location 不适用 美国西部、美国西部 2、美国东部、美国东部 2、美国中西部、美国中南部、欧洲西部、欧洲北部、亚洲东南部、亚洲东部、澳大利亚东部、巴西南部、加拿大中部、印度中部、英国南部、日本东部 美国西部 要用于此 API 调用的服务器位置
Subscription key 文本值 要用于此 API 调用的订阅密钥
Text 文本值列表 要分析的文本或文本列表
Language 文本值 文本的语言
Timeout 数值 30 代理在与服务器建立连接失败之前应等待的时间(秒)

生成的变量

参数 类型​​ 说明
JSONResponse 自定义对象 API 响应结果
StatusCode 数值 返回的状态代码

异常

例外 描述
请求已超时 指示在执行请求时已超时
无法调用认知服务 指示在尝试调用认知服务时出现问题

情绪

调用名为“文本分析 - 情绪”的 Microsoft 认知服务

输入参数

参数 可选 接受 默认值 说明
Server location 不适用 美国西部、美国西部 2、美国东部、美国东部 2、美国中西部、美国中南部、欧洲西部、欧洲北部、亚洲东南部、亚洲东部、澳大利亚东部、巴西南部、加拿大中部、印度中部、英国南部、日本东部 美国西部 要用于此 API 调用的服务器位置
Subscription key 文本值 要用于此 API 调用的订阅密钥
文本 文本值列表 文本
语言 文本值 两个字母的 ISO 639-1 表示文本的语言
Timeout 数值 30 代理在与服务器建立连接失败之前应等待的时间(秒)

生成的变量

参数 类型​​ 说明
JSONResponse 自定义对象 API 响应结果
StatusCode 数值 返回的状态代码

异常

例外 描述
请求已超时 指示在执行请求时已超时
无法调用认知服务 指示在尝试调用认知服务时出现问题