Translator - Transliterate

Serviço:

Azure AI Services

Versão da API:

3.0

Converte o texto de um idioma em um script em outro tipo de script. Exemplo- Escrita japonesa "こんにちは" Mesma palavra na escrita latina "konnichiha"

POST {Endpoint}/transliterate?api-version=3.0&language={language}&fromScript={fromScript}&toScript={toScript}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
Endpoint	path	True	string	Pontos de extremidade dos Serviços Cognitivos com suporte
api-version	query	True	string	Versão da API solicitada pelo cliente. O valor deve ser 3.0.
fromScript	query	True	string	Especifica o script usado pelo texto de entrada. Pesquise idiomas com suporte usando o transliteration escopo, para localizar scripts de entrada disponíveis para o idioma selecionado.
language	query	True	string	Especifica o idioma do texto a ser convertido de um script para outro. Os idiomas possíveis são listados no transliteration escopo obtido consultando o serviço para seus idiomas suportados.
toScript	query	True	string	Especifica o script de saída. Pesquise idiomas com suporte usando o transliteration escopo para localizar scripts de saída disponíveis para a combinação selecionada de idioma de entrada e script de entrada.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
X-ClientTraceId		string	Um GUID gerado pelo cliente para identificar exclusivamente a solicitação. Observe que você pode omitir esse cabeçalho se incluir a ID de rastreamento na cadeia de caracteres de consulta usando um parâmetro de consulta chamado ClientTraceId.

Corpo da solicitação

Nome	Tipo	Description
texts	TransliterateTextInput[]	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. 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 espaços. Todo o texto incluído na solicitação não pode exceder 5.000 caracteres, incluindo espaços. 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 string que é o resultado da conversão da string de entrada no script de saída. script- Uma string especificando o script usado na saída.

Respostas

Nome	Tipo	Description
200 OK	TransliterateResult[]	Êxito
Other Status Codes	ErrorMessage	Resposta de erro.

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

Ocp-Apim-Subscription-Region

Tipo: apiKey
Em: header

Exemplos

Transliterate success example

Solicitação de exemplo

HTTP

POST https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&language=ja&fromScript=jpan&toScript=latn

Resposta de exemplo

Código de status:

200

[
  {
    "text": "sodeska",
    "script": "latn"
  }
]

Definições

Nome	Description
Error
ErrorMessage
TransliterateResult	Exemplo de uma solicitação transliterada bem-sucedida
TransliterateTextInput	Texto necessário para uma solicitação de transliteração

Error

Objeto

Nome	Tipo	Description
code	string
message	string

ErrorMessage

Objeto

Nome	Tipo	Description
error	Error

TransliterateResult

Objeto

Exemplo de uma solicitação transliterada bem-sucedida

Nome	Tipo	Description
script	string
text	string

TransliterateTextInput

Objeto

Texto necessário para uma solicitação de transliteração

Nome	Tipo	Description
text	string