Translator - Transliterate

Service:

Azure AI Services

Version d'API:

3.0

Convertit le texte d’une langue d’une écriture en un autre type d’écriture. Exemple- Script japonais « こんにちは » Même mot en script latin « konnichiha »

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
Endpoint	path	True	string	Points de terminaison Cognitive Services pris en charge
api-version	query	True	string	Version de l’API demandée par le client. La valeur doit être 3,0.
fromScript	query	True	string	Spécifie le script utilisé par le texte d’entrée. Recherchez les langues prises en charge à l’aide de l’étendue pour trouver les transliteration scripts d’entrée disponibles pour la langue sélectionnée.
language	query	True	string	Spécifie la langue du texte à convertir d’un script à un autre. Les langues possibles sont répertoriées dans l’étendue transliteration obtenue en interrogeant le service pour les langues prises en charge.
toScript	query	True	string	Spécifie le script de sortie. Recherchez les langues prises en charge à l’aide de l’étendue pour trouver les transliteration scripts de sortie disponibles pour la combinaison sélectionnée de langue d’entrée et de script d’entrée.

En-tête de la demande

Nom	Obligatoire	Type	Description
X-ClientTraceId		string	GUID généré par le client pour identifier de manière unique la requête. Notez que vous pouvez omettre cet en-tête si vous incluez l’ID de trace dans la chaîne de requête à l’aide d’un paramètre de requête nommé ClientTraceId.

Corps de la demande

Nom	Type	Description
texts	TransliterateTextInput[]	Corps de la requête Le corps de la demande est un tableau JSON. Chaque élément du tableau est un objet JSON avec une propriété de chaîne nommée Text, qui représente la chaîne à convertir. Les limites suivantes s'appliquent : Le tableau peut avoir au maximum 10 éléments. La valeur de texte d’un élément de tableau ne peut pas dépasser 1 000 caractères, espaces compris. L’ensemble du texte inclus dans la demande ne peut pas dépasser 5 000 caractères, espaces compris. Corps de réponse Une réponse correcte est un tableau JSON avec un résultat pour chaque élément dans le tableau d’entrée. Un objet de résultat inclut les propriétés suivantes : text- Une chaîne qui est le résultat de la conversion de la chaîne d’entrée en script de sortie. script- Une chaîne spécifiant le script utilisé dans la sortie.

Réponses

Nom	Type	Description
200 OK	TransliterateResult[]	Succès
Other Status Codes	ErrorMessage	Réponse d’erreur.

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
Dans: header

Ocp-Apim-Subscription-Key

Type: apiKey
Dans: header

Ocp-Apim-Subscription-Region

Type: apiKey
Dans: header

Exemples

Transliterate success example

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:

200

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

Définitions

Nom	Description
Error
ErrorMessage
TransliterateResult	Exemple d’une demande de translittération réussie
TransliterateTextInput	Texte nécessaire pour une demande de translittération

Error

Object

Nom	Type	Description
code	string
message	string

ErrorMessage

Object

Nom	Type	Description
error	Error

TransliterateResult

Object

Exemple d’une demande de translittération réussie

Nom	Type	Description
script	string
text	string

TransliterateTextInput

Object

Texte nécessaire pour une demande de translittération

Nom	Type	Description
text	string