Partilhar via


Translator - Transliterate

Converte o texto de um idioma em um script em outro tipo de script. Exemplo- Script japonês "こんにちは" Mesma palavra em alfabeto latino "konnichiha"

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

Parâmetros do URI

Name Em Necessário Tipo Description
Endpoint
path True

string

Pontos de extremidade de Serviços Cognitivos suportados

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 suportados usando o transliteration escopo, para encontrar 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 suportados usando o transliteration escopo, para encontrar scripts de saída disponíveis para a combinação selecionada de idioma de entrada e script de entrada.

Cabeçalho do Pedido

Name Necessá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 do Pedido

Name Tipo Description
texts

TransliterateTextInput[]

Corpo de solicitação

O corpo da solicitação é uma matriz JSON. Cada elemento de matriz é um objeto JSON com uma propriedade string chamada Text, que representa a cadeia de caracteres a ser convertida. Aplicam-se as seguintes limitações:

  • 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.
  • O texto inteiro 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 result inclui as seguintes propriedades:

  • text- Uma string que é o resultado da conversão da string de entrada para o script de saída.
  • script- Uma string especificando o script usado na saída.

Respostas

Name Tipo Description
200 OK

TransliterateResult[]

Sucesso

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

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Description
Error
ErrorMessage
TransliterateResult

Exemplo de uma solicitação transliterada bem-sucedida

TransliterateTextInput

Texto necessário para um pedido transliterado

Error

Name Tipo Description
code

string

message

string

ErrorMessage

Name Tipo Description
error

Error

TransliterateResult

Exemplo de uma solicitação transliterada bem-sucedida

Name Tipo Description
script

string

text

string

TransliterateTextInput

Texto necessário para um pedido transliterado

Name Tipo Description
text

string