Contêiner: Texto Transliterado

Artigo
05/04/2024

Converter caracteres ou letras de um idioma de origem para os caracteres ou letras correspondentes de um idioma de destino.

URL de solicitação

POST pedir:

 POST http://localhost:{port}/transliterate?api-version=3.0&language={language}&fromScript={fromScript}&toScript={toScript}

ConfiraSuporte à Rede Virtual para ver a configuração e o suporte de ponto de extremidade privado e de rede selecionado do serviço de Tradução.

Parâmetros da solicitação

Os parâmetros de solicitação passados na cadeia de caracteres de consulta são:

Parâmetro de consulta	Descrição	Condição
api-version	Versão da API solicitada pelo cliente. O valor precisa ser `3.0`.	Parâmetro obrigatório
linguagem	Especifica o idioma de origem do texto a ser convertido de um script para outro.	Parâmetro obrigatório
fromScript	Especifica o script usado pelo texto de entrada.	Parâmetro obrigatório
toScript	Especifica o script de saída.	Parâmetro obrigatório

Você pode consultar o serviço para obter os idiomas suportados pelo transliteration escopo.
Consulte tambémSuporte a idiomas para transliteração.

Cabeçalhos da solicitação

Cabeçalhos	Descrição	Condição
Cabeçalhos de autenticação	Consulteas opções disponíveis para autenticação	Cabeçalho de solicitação obrigatório
Content-Type	Especifica o tipo de conteúdo da carga. Valor possível: `application/json`	Cabeçalho de solicitação obrigatório
Content-Length	O tamanho do corpo da solicitação.	Opcional
X-ClientTraceId	Um GUID gerado pelo cliente para identificar exclusivamente a solicitação. É possível omitir esse cabeçalho se incluir a ID de rastreamento na cadeia de caracteres de consulta usando um parâmetro de consulta nomeado `ClientTraceId`.	Opcional

Corpo da resposta

Uma resposta bem-sucedida é uma matriz JSON com um resultado para cada elemento na matriz de entrada. Um objeto de resultado inclui as seguintes propriedades:

text: uma cadeia de caracteres que resulta da conversão da cadeia de caracteres de entrada no script de saída.
script: uma cadeia de caracteres especificando o script usado na saída.

Cabeçalhos de resposta

Cabeçalhos	Descrição
X-RequestId	Valor gerado pelo serviço para identificar a solicitação. Ele pode ser usado para fins de solução de problemas.

Solicitação de exemplo

curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn"

Exemplo de corpo da solicitação

O corpo da solicitação é uma matriz JSON. Cada elemento da matriz é um objeto JSON com uma propriedade de cadeia de caracteres denominada Text, que representa a cadeia de caracteres a converter.

[
    {"Text":"こんにちは"},
    {"Text":"さようなら"}
]

As seguintes limitações se aplicam:

A matriz pode ter no máximo 10 elementos.
O valor de texto de um elemento de matriz não pode exceder 1.000 caracteres, incluindo os espaços.
Todo o texto incluído na solicitação não pode exceder 5.000 caracteres, incluindo espaços.

Exemplo de resposta JSON:

[
  {
    "text": "Kon'nichiwa",
    "script": "Latn"
  },
  {
    "text": "sayonara",
    "script": "Latn"
  }
]

Observação

Cada exemplo é executado no localhost que você especificou com o docker run comando.
Enquanto o contêiner está em execução, localhost aponta para o próprio contêiner.
Você não precisa usar localhost:5000o . Você pode usar qualquer porta que ainda não esteja em uso no ambiente do host.

Transliterar com API REST


  curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "Content-Type: application/json" -d "[{'Text':'こんにちは'},{'Text':'さようなら'}]"

Próximas etapas

Saiba mais sobre transliteração de texto

Compartilhar via