Contenedor: transliteración de texto

Artículo
09/01/2024

Convierta caracteres o letras de un idioma de origen en los caracteres o letras correspondientes de un idioma de destino.

URL de la solicitud

POST pedir:

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

Consulte Compatibilidad de red virtual con el servicio Translator seleccionado para la configuración y el soporte técnico de la red privada y el punto de conexión privado.

Parámetros de solicitud

Los parámetros de solicitud que se pasaron en la cadena de consulta son:

Parámetro de consulta	Descripción	Condición
api-version	Versión de la API que el cliente solicitó. El valor debe ser `3.0`.	Parámetro obligatorio
language	Especifica el idioma de origen del texto que se va a convertir de un script a otro.	Parámetro obligatorio
fromScript	Especifica el script que usa el texto de entrada.	Parámetro obligatorio
toScript	Especifica el nombre del script de salida.	Parámetro obligatorio

Puede consultar el servicio para transliteration conocer los idiomas admitidos en el ámbito.
Consulte también Compatibilidad con el lenguaje para la transliteración.

Encabezados de solicitud

encabezados	Descripción	Condición
Encabezados de autenticación	Consulte las opciones disponibles para la autenticación.	Encabezado de solicitud requerido
Content-Type	Especifica el tipo de contenido de la carga. Valor posible: `application/json`	Encabezado de solicitud requerido
Content-Length	Este encabezado especifica la longitud del cuerpo de la solicitud.	Opcional
X-ClientTraceId	GUID generado por el cliente para identificar de forma única la solicitud. Puede omitir este encabezado si incluye el id. de seguimiento en la cadena de la consulta mediante un parámetro de consulta denominado `ClientTraceId`.	Opcional

Response body

Una respuesta correcta es una matriz JSON, que cuenta con un resultado para cada elemento en la matriz de entrada. Un objeto del resultado incluye las siguientes propiedades:

text: cadena que resulta de convertir la cadena de entrada al script de salida.
script: cadena que especifica el script que se usa en la salida.

Encabezados de respuesta

encabezados	Descripción
X-RequestId	Valor generado por el servicio para identificar la solicitud. Se puede usar con fines de solución de problemas.

Solicitud de ejemplo

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

Ejemplo de 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.

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

Se aplican las siguientes limitaciones:

La matriz puede tener un máximo de 10 elementos.
El valor de texto de un elemento de la matriz no puede superar los 1000 caracteres, incluidos los espacios.
El texto completo incluido en la solicitud no puede superar los 5000 caracteres, incluidos los espacios.

Respuesta JSON de ejemplo:

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

Nota:

Cada ejemplo se ejecuta en el localhost que especificó con el docker run comando .
Mientras se ejecuta el contenedor, localhost apunta al propio contenedor.
No tiene que usar localhost:5000. Puede usar cualquier puerto que aún no esté en uso en el entorno de host.

Transliteración con la 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':'さようなら'}]"

Pasos siguientes

Más información sobre la transliteración de texto

Compartir vía