Краткое руководство. Определение языка текста

Справочная документация | Больше примеров | Пакет (NuGet) | Исходный код библиотеки

В этом кратком руководстве описано, как создать приложение для определения языка с использованием клиентской библиотеки для .NET. В следующем примере вы создадите приложение C#, которое может определить язык, на который был написан пример текста.

Предварительные требования

• Подписка Azure — создайте бесплатную учетную запись.
• Интегрированная среда разработки Visual Studio.

Установка

Создание ресурса Azure

Чтобы использовать приведенный ниже пример кода, необходимо развернуть ресурс Azure. Этот ресурс будет содержать ключ и конечную точку, используемую для проверки подлинности вызовов API, которые вы отправляете на язык Azure.

1. Используйте следующую ссылку, чтобы создать языковой ресурс с помощью портал Azure. Вам нужно войти с помощью подписки Azure.

2. На появившемся экране выбора дополнительных функций нажмите кнопку "Продолжить", чтобы создать ресурс.

   

3. На экране "Создание языка" укажите следующие сведения:

   Подробности	Описание
   Подписка	Учетная запись подписки, с которым будет связан ваш ресурс. Выберите подписку Azure в раскрывающемся меню.
   Группа ресурсов	Группа ресурсов — это контейнер, в который хранятся создаваемые ресурсы. Выберите Создать, чтобы создать группу ресурсов.
   Область/регион	Расположение языкового ресурса. Различные регионы могут привести к задержке в зависимости от физического расположения, но не влияют на доступность ресурса во время выполнения. В этом кратком руководстве выберите доступный регион рядом с вами или выберите восточную часть США.
   Имя.	Название вашего языкового ресурса. Это имя также будет использоваться для создания URL-адреса конечной точки, который приложения будут использовать для отправки запросов API.
   Ценовая категория	Ценовая категория языкового ресурса. Вы можете использовать тариф F0 (Бесплатный), чтобы попробовать сервис и позже обновить его до платного тарифа для коммерческого использования.

   

4. Убедитесь, что установлен флажок "Уведомление об Ответственном ИИ".

5. В нижней части страницы выберите Просмотреть и создать.

6. На появившемся экране убедитесь, что проверка прошла, и правильно ввели данные. Затем выберите Создать.

Получите ключ и конечную точку

Затем вам потребуется ключ и конечная точка из ресурса для подключения приложения к API. Ключ и конечную точку вы вставите в код позже в процессе быстрого старта.

1. После успешного развертывания ресурса языка Azure нажмите кнопку "Перейти к ресурсу " в разделе "Дальнейшие действия".

   

2. На экране ресурса выберите ключи и конечную точку на левой панели. Вы будете использовать один из ваших ключей и вашу конечную точку на следующих этапах.

   

Создание переменной среды

Приложение должно пройти проверку подлинности для отправки запросов API. Для рабочей среды используйте безопасный способ хранения и доступа к учетным данным. В этом примере учетные данные записываются в переменные среды на локальном компьютере, на котором запущено приложение.

Чтобы задать переменную среды для ключа ресурса языка, откройте окно консоли и следуйте инструкциям в вашей операционной системе и среде разработки.

• Чтобы задать LANGUAGE_KEY переменную среды, замените your-key одним из ключей ресурса.
• Чтобы задать переменную среды, замените LANGUAGE_ENDPOINT на конечную точку для вашего ресурса.

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Создание приложения .NET Core

С помощью интегрированной среды разработки Visual Studio создайте консольное приложение .NET Core. При этом создается проект Hello World с одним исходным файлом C#: program.cs.

Установите клиентную библиотеку, щелкнув решение правой кнопкой мыши в обозревателе решений и выбрав пункт "Управление пакетами NuGet". В открывшемся диспетчере пакетов выберите Просмотр и выполните поиск по запросу Azure.AI.TextAnalytics. Выберите версию 5.2.0, а затем Установить. Вы также можете использовать консоль диспетчера пакетов.

Пример кода

Скопируйте следующий код в файл program.cs. Теперь выполните код.

using Azure;
using System;
using Azure.AI.TextAnalytics;

namespace LanguageDetectionExample
{
    class Program
    {
        // This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT".
        static void LanguageDetectionExample(TextAnalyticsClient client)
        {
            DetectedLanguage detectedLanguage = client.DetectLanguage("Ce document est rédigé en Français.");
            Console.WriteLine("Language:");
            Console.WriteLine($"\t{detectedLanguage.Name},\tISO-6391: {detectedLanguage.Iso6391Name}\n");
        }

        static void Main(string[] args)
        {
            string languageKey = Environment.GetEnvironmentVariable("LANGUAGE_KEY");
            string languageEndpoint = Environment.GetEnvironmentVariable("LANGUAGE_ENDPOINT");

            if (string.IsNullOrWhiteSpace(languageKey) || string.IsNullOrWhiteSpace(languageEndpoint))
            {
                Console.WriteLine("Set the LANGUAGE_KEY and LANGUAGE_ENDPOINT environment variables before running this sample.");
                return;
            }

            var endpoint = new Uri(languageEndpoint);
            var credentials = new AzureKeyCredential(languageKey);
            var client = new TextAnalyticsClient(endpoint, credentials);

            LanguageDetectionExample(client);

            Console.Write("Press any key to exit.");
            Console.ReadKey();
        }

    }
}

Выходные данные

Language:
    French, ISO-6391: fr

Справочная документация | Больше примеров | Пакет (Maven) | Исходный код библиотеки

В этом кратком руководстве описано, как создать приложение для определения языка с использованием клиентской библиотеки для Java. В следующем примере вы создадите приложение Java, которое может определить язык, на который был написан пример текста.

Предварительные требования

• Подписка Azure — создайте бесплатную учетную запись.
• Пакет разработчиков Java (JDK) версии 8 или более поздней.

Установка

Создание ресурса Azure

Чтобы использовать приведенный ниже пример кода, необходимо развернуть ресурс Azure. Этот ресурс будет содержать ключ и конечную точку, используемую для проверки подлинности вызовов API, которые вы отправляете на язык Azure.

1. Используйте следующую ссылку, чтобы создать языковой ресурс с помощью портал Azure. Вам нужно войти с помощью подписки Azure.

2. На появившемся экране выбора дополнительных функций нажмите кнопку "Продолжить", чтобы создать ресурс.

   

3. На экране "Создание языка" укажите следующие сведения:

   Подробности	Описание
   Подписка	Учетная запись подписки, с которым будет связан ваш ресурс. Выберите подписку Azure в раскрывающемся меню.
   Группа ресурсов	Группа ресурсов — это контейнер, в который хранятся создаваемые ресурсы. Выберите Создать, чтобы создать группу ресурсов.
   Область/регион	Расположение языкового ресурса. Различные регионы могут привести к задержке в зависимости от физического расположения, но не влияют на доступность ресурса во время выполнения. В этом кратком руководстве выберите доступный регион рядом с вами или выберите восточную часть США.
   Имя.	Название вашего языкового ресурса. Это имя также будет использоваться для создания URL-адреса конечной точки, который приложения будут использовать для отправки запросов API.
   Ценовая категория	Ценовая категория языкового ресурса. Вы можете использовать тариф F0 (Бесплатный), чтобы попробовать сервис и позже обновить его до платного тарифа для коммерческого использования.

   

4. Убедитесь, что установлен флажок "Уведомление об Ответственном ИИ".

5. В нижней части страницы выберите Просмотреть и создать.

6. На появившемся экране убедитесь, что проверка прошла, и правильно ввели данные. Затем выберите Создать.

Получите ключ и конечную точку

Затем вам потребуется ключ и конечная точка из ресурса для подключения приложения к API. Ключ и конечную точку вы вставите в код позже в процессе быстрого старта.

1. После успешного развертывания ресурса языка Azure нажмите кнопку "Перейти к ресурсу " в разделе "Дальнейшие действия".

   

2. На экране ресурса выберите ключи и конечную точку на левой панели. Вы будете использовать один из ваших ключей и вашу конечную точку на следующих этапах.

   

Создание переменной среды

Приложение должно пройти проверку подлинности для отправки запросов API. Для рабочей среды используйте безопасный способ хранения и доступа к учетным данным. В этом примере учетные данные записываются в переменные среды на локальном компьютере, на котором запущено приложение.

Чтобы задать переменную среды для ключа ресурса языка, откройте окно консоли и следуйте инструкциям в вашей операционной системе и среде разработки.

• Чтобы задать LANGUAGE_KEY переменную среды, замените your-key одним из ключей ресурса.
• Чтобы задать переменную среды, замените LANGUAGE_ENDPOINT на конечную точку для вашего ресурса.

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Добавление клиентской библиотеки

Создайте проект Maven в предпочтительной среде разработки или IDE. Потом добавьте следующую зависимость в файл pom.xml проекта. Синтаксис реализации для других средств сборки можно найти в Интернете.

<dependencies>
     <dependency>
        <groupId>com.azure</groupId>
        <artifactId>azure-ai-textanalytics</artifactId>
        <version>5.2.0</version>
    </dependency>
</dependencies>

Пример кода

Создайте файл Java с именем Example.java. Откройте файл и скопируйте приведенный ниже код. Теперь выполните код.

import com.azure.core.credential.AzureKeyCredential;
import com.azure.ai.textanalytics.models.*;
import com.azure.ai.textanalytics.TextAnalyticsClientBuilder;
import com.azure.ai.textanalytics.TextAnalyticsClient;

public class Example {

    // This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
    private static String languageKey = System.getenv("LANGUAGE_KEY");
    private static String languageEndpoint = System.getenv("LANGUAGE_ENDPOINT");

    public static void main(String[] args) {
        if (languageKey == null || languageKey.isBlank() || languageEndpoint == null || languageEndpoint.isBlank()) {
            throw new IllegalArgumentException("Missing LANGUAGE_KEY or LANGUAGE_ENDPOINT environment variables");
        }
        TextAnalyticsClient client = authenticateClient(languageKey, languageEndpoint);
        detectLanguageExample(client);
    }
    // Method to authenticate the client object with your key and endpoint
    static TextAnalyticsClient authenticateClient(String key, String endpoint) {
        return new TextAnalyticsClientBuilder()
                .credential(new AzureKeyCredential(key))
                .endpoint(endpoint)
                .buildClient();
    }
    // Example method for detecting the language of text
    static void detectLanguageExample(TextAnalyticsClient client)
    {
        // The text to be analyzed.
        String text = "Ce document est rédigé en Français.";

        DetectedLanguage detectedLanguage = client.detectLanguage(text);
        System.out.printf("Detected primary language: %s, ISO 6391 name: %s, score: %.2f.%n",
                detectedLanguage.getName(),
                detectedLanguage.getIso6391Name(),
                detectedLanguage.getConfidenceScore());
    }
}

Выходные данные

Detected primary language: French, ISO 6391 name: fr, score: 1.00.

Справочная документация | Больше примеров | Пакет (npm) | Исходный код библиотеки

В этом кратком руководстве описано, как создать приложение для определения языка с использованием клиентской библиотеки для Node.js. В следующем примере вы создадите приложение JavaScript, которое может определить язык, на который был написан пример текста.

Предварительные требования

• Подписка Azure — создайте бесплатную учетную запись.
• Node.js версии 14 LTS или выше

Установка

Создание ресурса Azure

Чтобы использовать приведенный ниже пример кода, необходимо развернуть ресурс Azure. Этот ресурс будет содержать ключ и конечную точку, используемую для проверки подлинности вызовов API, которые вы отправляете на язык Azure.

1. Используйте следующую ссылку, чтобы создать языковой ресурс с помощью портал Azure. Вам нужно войти с помощью подписки Azure.

2. На появившемся экране выбора дополнительных функций нажмите кнопку "Продолжить", чтобы создать ресурс.

   

3. На экране "Создание языка" укажите следующие сведения:

   Подробности	Описание
   Подписка	Учетная запись подписки, с которым будет связан ваш ресурс. Выберите подписку Azure в раскрывающемся меню.
   Группа ресурсов	Группа ресурсов — это контейнер, в который хранятся создаваемые ресурсы. Выберите Создать, чтобы создать группу ресурсов.
   Область/регион	Расположение языкового ресурса. Различные регионы могут привести к задержке в зависимости от физического расположения, но не влияют на доступность ресурса во время выполнения. В этом кратком руководстве выберите доступный регион рядом с вами или выберите восточную часть США.
   Имя.	Название вашего языкового ресурса. Это имя также будет использоваться для создания URL-адреса конечной точки, который приложения будут использовать для отправки запросов API.
   Ценовая категория	Ценовая категория языкового ресурса. Вы можете использовать тариф F0 (Бесплатный), чтобы попробовать сервис и позже обновить его до платного тарифа для коммерческого использования.

   

4. Убедитесь, что установлен флажок "Уведомление об Ответственном ИИ".

5. В нижней части страницы выберите Просмотреть и создать.

6. На появившемся экране убедитесь, что проверка прошла, и правильно ввели данные. Затем выберите Создать.

Получите ключ и конечную точку

Затем вам потребуется ключ и конечная точка из ресурса для подключения приложения к API. Ключ и конечную точку вы вставите в код позже в процессе быстрого старта.

1. После успешного развертывания ресурса языка Azure нажмите кнопку "Перейти к ресурсу " в разделе "Дальнейшие действия".

   

2. На экране ресурса выберите ключи и конечную точку на левой панели. Вы будете использовать один из ваших ключей и вашу конечную точку на следующих этапах.

   

Создание переменной среды

Приложение должно пройти проверку подлинности для отправки запросов API. Для рабочей среды используйте безопасный способ хранения и доступа к учетным данным. В этом примере учетные данные записываются в переменные среды на локальном компьютере, на котором запущено приложение.

Чтобы задать переменную среды для ключа ресурса языка, откройте окно консоли и следуйте инструкциям в вашей операционной системе и среде разработки.

• Чтобы задать LANGUAGE_KEY переменную среды, замените your-key одним из ключей ресурса.
• Чтобы задать переменную среды, замените LANGUAGE_ENDPOINT на конечную точку для вашего ресурса.

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Создание нового приложения Node.js

В окне консоли (например, cmd, PowerShell или Bash) создайте новый каталог для приложения и перейдите в него.

mkdir myapp 

cd myapp

Выполните команду npm init, чтобы создать приложение узла с помощью файла package.json.

npm init

Установка клиентской библиотеки

Установите пакет npm:

npm install @azure/ai-language-text

Пример кода

Откройте файл и скопируйте приведенный ниже код. Теперь выполните код.

"use strict";

const { AzureKeyCredential, TextAnalysisClient } = require("@azure/ai-language-text");

// This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
const key = process.env.LANGUAGE_KEY;
const endpoint = process.env.LANGUAGE_ENDPOINT;

if (!key || !endpoint) {
  throw new Error(
    "Missing LANGUAGE_KEY or LANGUAGE_ENDPOINT environment variables."
  );
}

//Example sentences in different languages to be analyzed
const documents = [
    "This document is written in English.",
    "这是一个用中文写的文件",
];

//Example of how to use the client library to detect language
async function main() {
    console.log("== Language detection sample ==");
  
    const client = new TextAnalysisClient(endpoint, new AzureKeyCredential(key));
  
    const result = await client.analyze("LanguageDetection", documents);
  
    for (const doc of result) {
      if (!doc.error) {
        console.log(
          `ID ${doc.id} - Primary language: ${doc.primaryLanguage.name} (iso6391 name: ${doc.primaryLanguage.iso6391Name})`
        );
      }
    }
}

main().catch((err) => {
    console.error("The sample encountered an error:", err);
});

Выходные данные

== Language detection sample ==
ID 0 - Primary language: English (iso6391 name: en)
ID 1 - Primary language: Chinese_Simplified (iso6391 name: zh_chs)

Справочная документация | Дополнительные примеры | Пакет (PyPi) | Исходный код библиотеки

В этом кратком руководстве описано, как создать приложение для определения языка с использованием клиентской библиотеки для Python. В следующем примере вы создадите приложение Python, которое может определить язык, на который был написан пример текста.

Предварительные требования

• Подписка Azure — создайте бесплатную учетную запись.
• Python 3.8 или более поздней версии

Установка

Создание ресурса Azure

Чтобы использовать приведенный ниже пример кода, необходимо развернуть ресурс Azure. Этот ресурс будет содержать ключ и конечную точку, используемую для проверки подлинности вызовов API, которые вы отправляете на язык Azure.

1. Используйте следующую ссылку, чтобы создать языковой ресурс с помощью портал Azure. Вам нужно войти с помощью подписки Azure.

2. На появившемся экране выбора дополнительных функций нажмите кнопку "Продолжить", чтобы создать ресурс.

   

3. На экране "Создание языка" укажите следующие сведения:

   Подробности	Описание
   Подписка	Учетная запись подписки, с которым будет связан ваш ресурс. Выберите подписку Azure в раскрывающемся меню.
   Группа ресурсов	Группа ресурсов — это контейнер, в который хранятся создаваемые ресурсы. Выберите Создать, чтобы создать группу ресурсов.
   Область/регион	Расположение языкового ресурса. Различные регионы могут привести к задержке в зависимости от физического расположения, но не влияют на доступность ресурса во время выполнения. В этом кратком руководстве выберите доступный регион рядом с вами или выберите восточную часть США.
   Имя.	Название вашего языкового ресурса. Это имя также будет использоваться для создания URL-адреса конечной точки, который приложения будут использовать для отправки запросов API.
   Ценовая категория	Ценовая категория языкового ресурса. Вы можете использовать тариф F0 (Бесплатный), чтобы попробовать сервис и позже обновить его до платного тарифа для коммерческого использования.

   

4. Убедитесь, что установлен флажок "Уведомление об Ответственном ИИ".

5. В нижней части страницы выберите Просмотреть и создать.

6. На появившемся экране убедитесь, что проверка прошла, и правильно ввели данные. Затем выберите Создать.

Получите ключ и конечную точку

Затем вам потребуется ключ и конечная точка из ресурса для подключения приложения к API. Ключ и конечную точку вы вставите в код позже в процессе быстрого старта.

1. После успешного развертывания ресурса языка Azure нажмите кнопку "Перейти к ресурсу " в разделе "Дальнейшие действия".

   

2. На экране ресурса выберите ключи и конечную точку на левой панели. Вы будете использовать один из ваших ключей и вашу конечную точку на следующих этапах.

   

Создание переменной среды

Приложение должно пройти проверку подлинности для отправки запросов API. Для рабочей среды используйте безопасный способ хранения и доступа к учетным данным. В этом примере учетные данные записываются в переменные среды на локальном компьютере, на котором запущено приложение.

Чтобы задать переменную среды для ключа ресурса языка, откройте окно консоли и следуйте инструкциям в вашей операционной системе и среде разработки.

• Чтобы задать LANGUAGE_KEY переменную среды, замените your-key одним из ключей ресурса.
• Чтобы задать переменную среды, замените LANGUAGE_ENDPOINT на конечную точку для вашего ресурса.

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Установка клиентской библиотеки

После установки Python вы можете установить клиентскую библиотеку с помощью следующей команды:

pip install azure-ai-textanalytics==5.2.0

Пример кода

Создайте файл Python и скопируйте код ниже. Теперь выполните код.

# This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
import os

from azure.ai.textanalytics import TextAnalyticsClient
from azure.core.credentials import AzureKeyCredential

language_key = os.environ.get("LANGUAGE_KEY")
language_endpoint = os.environ.get("LANGUAGE_ENDPOINT")

if not language_key or not language_endpoint:
    raise ValueError("Missing LANGUAGE_KEY or LANGUAGE_ENDPOINT environment variables")

# Authenticate the client using your key and endpoint
def authenticate_client():
    ta_credential = AzureKeyCredential(language_key)
    text_analytics_client = TextAnalyticsClient(
            endpoint=language_endpoint,
            credential=ta_credential)
    return text_analytics_client

client = authenticate_client()

# Example method for detecting the language of text
def language_detection_example(client):
    try:
        documents = ["Ce document est rédigé en Français."]
        response = client.detect_language(documents = documents, country_hint = 'us')[0]
        print("Language: ", response.primary_language.name)

    except Exception as err:
        print("Encountered exception. {}".format(err))
language_detection_example(client)

Выходные данные

Language:  French

Справочная документация

В этом кратком руководстве описано, как отправлять запросы на определение языка с использованием REST API. В следующем примере используется cURL для идентификации языка, на который был написан пример текста.

Предварительные требования

• Подписка Azure — создайте бесплатную учетную запись.

Установка

Создание ресурса Azure

Чтобы использовать приведенный ниже пример кода, необходимо развернуть ресурс Azure. Этот ресурс будет содержать ключ и конечную точку, используемую для проверки подлинности вызовов API, которые вы отправляете на язык Azure.

1. Используйте следующую ссылку, чтобы создать языковой ресурс с помощью портал Azure. Вам нужно войти с помощью подписки Azure.

2. На появившемся экране выбора дополнительных функций нажмите кнопку "Продолжить", чтобы создать ресурс.

   

3. На экране "Создание языка" укажите следующие сведения:

   Подробности	Описание
   Подписка	Учетная запись подписки, с которым будет связан ваш ресурс. Выберите подписку Azure в раскрывающемся меню.
   Группа ресурсов	Группа ресурсов — это контейнер, в который хранятся создаваемые ресурсы. Выберите Создать, чтобы создать группу ресурсов.
   Область/регион	Расположение языкового ресурса. Различные регионы могут привести к задержке в зависимости от физического расположения, но не влияют на доступность ресурса во время выполнения. В этом кратком руководстве выберите доступный регион рядом с вами или выберите восточную часть США.
   Имя.	Название вашего языкового ресурса. Это имя также будет использоваться для создания URL-адреса конечной точки, который приложения будут использовать для отправки запросов API.
   Ценовая категория	Ценовая категория языкового ресурса. Вы можете использовать тариф F0 (Бесплатный), чтобы попробовать сервис и позже обновить его до платного тарифа для коммерческого использования.

   

4. Убедитесь, что установлен флажок "Уведомление об Ответственном ИИ".

5. В нижней части страницы выберите Просмотреть и создать.

6. На появившемся экране убедитесь, что проверка прошла, и правильно ввели данные. Затем выберите Создать.

Получите ключ и конечную точку

Затем вам потребуется ключ и конечная точка из ресурса для подключения приложения к API. Ключ и конечную точку вы вставите в код позже в процессе быстрого старта.

1. После успешного развертывания ресурса языка Azure нажмите кнопку "Перейти к ресурсу " в разделе "Дальнейшие действия".

   

2. На экране ресурса выберите ключи и конечную точку на левой панели. Вы будете использовать один из ваших ключей и вашу конечную точку на следующих этапах.

   

Создание переменной среды

Приложение должно пройти проверку подлинности для отправки запросов API. Для рабочей среды используйте безопасный способ хранения и доступа к учетным данным. В этом примере учетные данные записываются в переменные среды на локальном компьютере, на котором запущено приложение.

Чтобы задать переменную среды для ключа ресурса языка, откройте окно консоли и следуйте инструкциям в вашей операционной системе и среде разработки.

• Чтобы задать LANGUAGE_KEY переменную среды, замените your-key одним из ключей ресурса.
• Чтобы задать переменную среды, замените LANGUAGE_ENDPOINT на конечную точку для вашего ресурса.

setx LANGUAGE_KEY your-key

setx LANGUAGE_ENDPOINT your-endpoint

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

export LANGUAGE_KEY=your-key

export LANGUAGE_ENDPOINT=your-endpoint

Создание JSON-файла с примером текста запроса

В редакторе кода создайте файл с именем test_languagedetection_payload.json и скопируйте следующий пример JSON. Этот пример запроса будет отправлен в API на следующем шаге.

{
    "kind": "LanguageDetection",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "text": "This is a document written in English."
            }
        ]
    }
}

Сохраните test_languagedetection_payload.json где-нибудь на компьютере. Например, рабочий стол.

Отправка запроса на обнаружение языка

Используйте следующие команды, чтобы отправить запрос API с помощью используемой программы. Скопируйте команду в терминал и запустите ее.

curl -X POST "%LANGUAGE_ENDPOINT%/language/:analyze-text?api-version=2023-11-15-preview" ^
-H "Content-Type: application/json" ^
-H "Ocp-Apim-Subscription-Key: %LANGUAGE_KEY%" ^
-d "@C:\Users\<myaccount>\Desktop\test_languagedetection_payload.json"

curl.exe -X POST $env:LANGUAGE_ENDPOINT/language/:analyze-text?api-version=2023-11-15-preview `
-H "Content-Type: application/json" `
-H "Ocp-Apim-Subscription-Key: $env:LANGUAGE_KEY" `
-d "@C:\Users\<myaccount>\Desktop\test_languagedetection_payload.json"

curl -X POST $LANGUAGE_ENDPOINT/language/:analyze-text?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: $LANGUAGE_KEY" \
-d "@/home/mydir/test_languagedetection_payload.json"

curl -X POST $LANGUAGE_ENDPOINT/language/:analyze-text?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: $LANGUAGE_KEY" \
-d "@/home/mydir/test_languagedetection_payload.json"

Ответ JSON

{
    "kind": "LanguageDetectionResults",
    "results": {
        "documents": [
            {
                "id": "1",
                "detectedLanguage": {
                    "name": "English",
                    "iso6391Name": "en",
                    "confidenceScore": 1.0,
                    "script": "Latin",
                    "scriptCode": "Latn"
                },
                "warnings": []
            }
        ],
        "errors": [],
        "modelVersion": "2023-12-01"
    }
}

Используйте следующие команды, чтобы удалить переменные среды, созданные для этого краткого руководства.

reg delete "HKCU\Environment" /v LANGUAGE_KEY /f

reg delete "HKCU\Environment" /v LANGUAGE_ENDPOINT /f

unset LANGUAGE_KEY

unset LANGUAGE_ENDPOINT

unset LANGUAGE_KEY

unset LANGUAGE_ENDPOINT

Предварительные требования

• Подписка Azure. Если у вас нет учетной записи, вы можете создать ее бесплатно.
• Необходимые разрешения. Убедитесь, что пользователь, устанавливающий учетную запись и проект, имеет роль владельца учетной записи ИИ Azure на уровне подписки. Кроме того, роль участника или участника Cognitive Services в области подписки также соответствует этому требованию. Дополнительные сведения см. в разделе "Управление доступом на основе ролей" (RBAC).
• Ресурс Foundry. Создайте ресурс Foundry или просмотрите раздел "Настройка ресурса Foundry". В качестве альтернативы можно использовать языковой ресурс.
• Проект Foundry. Дополнительные сведения см. в разделе "Создание проекта Foundry".