Translator - Transliterate

Servicio:

Azure AI Services

Versión de la API:

3.0

Convierte el texto de un idioma en un alfabeto en otro tipo de alfabeto. Ejemplo: escritura japonesa "こんにちは" Misma palabra en escritura latina "konnichiha"

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
Endpoint	path	True	string	Puntos de conexión de Cognitive Services admitidos
api-version	query	True	string	Versión de la API que el cliente solicitó. El valor debe ser 3.0.
fromScript	query	True	string	Especifica el script usado por el texto de entrada. Busque idiomas admitidos mediante el transliteration ámbito para encontrar scripts de entrada disponibles para el idioma seleccionado.
language	query	True	string	Especifica el idioma del texto que se va a convertir de un script a otro. Los idiomas posibles se enumeran en el transliteration ámbito obtenido al consultar el servicio para conocer sus idiomas admitidos.
toScript	query	True	string	Especifica el script de salida. Busque los idiomas admitidos mediante el transliteration ámbito para encontrar scripts de salida disponibles para la combinación seleccionada de idioma de entrada y script de entrada.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
X-ClientTraceId		string	Guid generado por el cliente para identificar de forma única la solicitud. Tenga en cuenta que puede omitir este encabezado si incluye el identificador de seguimiento en la cadena de consulta mediante un parámetro de consulta denominado ClientTraceId.

Cuerpo de la solicitud

Nombre	Tipo	Description
texts	TransliterateTextInput[]	Cuerpo de la solicitud El cuerpo de la solicitud es una matriz JSON. Cada elemento de la matriz es un objeto JSON con una propiedad de cadena denominada Text, que representa la cadena que se va a convertir. Se presentan las siguientes limitaciones: La matriz puede tener como máximo 10 elementos. El valor de texto de un elemento de matriz no puede superar los 1.000 caracteres, incluidos los espacios. El texto completo incluido en la solicitud no puede exceder los 5.000 caracteres, incluidos los espacios. Cuerpo de respuesta Una respuesta correcta es una matriz JSON, que cuenta con un resultado para cada elemento en la matriz de entrada. Un objeto de resultado incluye las siguientes propiedades: text- Una cadena que es el resultado de convertir la cadena de entrada en el script de salida. script- Una cadena que especifica el script utilizado en la salida.

Respuestas

Nombre	Tipo	Description
200 OK	TransliterateResult[]	Éxito
Other Status Codes	ErrorMessage	Respuesta de error.

Seguridad

Ocp-Apim-Subscription-Key

Tipo: apiKey
En: header

Ocp-Apim-Subscription-Key

Tipo: apiKey
En: header

Ocp-Apim-Subscription-Region

Tipo: apiKey
En: header

Ejemplos

Transliterate success example

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:

200

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

Definiciones

Nombre	Description
Error
ErrorMessage
TransliterateResult	Ejemplo de una solicitud de transliteración correcta
TransliterateTextInput	Texto necesario para una solicitud transliterada

Error

Object

Nombre	Tipo	Description
code	string
message	string

ErrorMessage

Object

Nombre	Tipo	Description
error	Error

TransliterateResult

Object

Ejemplo de una solicitud de transliteración correcta

Nombre	Tipo	Description
script	string
text	string

TransliterateTextInput

Object

Texto necesario para una solicitud transliterada

Nombre	Tipo	Description
text	string