Translator - Transliterate

Servizio:

Azure AI Services

Versione API:

3.0

Converte il testo di una lingua in uno script in un altro tipo di script. Esempio- Script giapponese "こんにちは" Stessa parola nello script latino "konnichiha"

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
Endpoint	path	True	string	Endpoint di Servizi cognitivi supportati
api-version	query	True	string	Versione dell'API richiesta dal client. Il valore deve essere 3,0.
fromScript	query	True	string	Specifica lo script utilizzato dal testo di input. Cercare le lingue supportate usando l'ambito transliteration, per trovare gli script di input disponibili per la lingua selezionata.
language	query	True	string	Specifica la lingua del testo da convertire da uno script a un altro. Le lingue possibili sono elencate nell'ambito transliteration ottenuto eseguendo una query sul servizio per le lingue supportate.
toScript	query	True	string	Specifica lo script di output. Cercare le lingue supportate usando l'ambito transliteration, per trovare gli script di output disponibili per la combinazione selezionata di linguaggio di input e script di input.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
X-ClientTraceId		string	GUID generato dal client per identificare in modo univoco la richiesta. Si noti che è possibile omettere questa intestazione se si include l'ID di traccia nella stringa di query usando un parametro di query denominato ClientTraceId.

Corpo della richiesta

Nome	Tipo	Descrizione
texts	TransliterateTextInput[]	Corpo della richiesta Il corpo della richiesta è una matrice JSON. Ogni elemento della matrice è un oggetto JSON con una proprietà stringa denominata Text, che rappresenta la stringa da convertire. Si applicano le limitazioni seguenti: La matrice può avere al massimo 10 elementi. Il valore di testo di un elemento di matrice non può superare 1.000 caratteri, inclusi gli spazi. L'intero testo incluso nella richiesta non può superare i 5.000 caratteri, inclusi gli spazi. Corpo della risposta Una risposta con esito positivo è una matrice JSON con un risultato per ogni elemento nella matrice di input. Un oggetto risultato include le proprietà seguenti: text: stringa che è il risultato della conversione della stringa di input nello script di output. script: stringa che specifica lo script usato nell'output.

Risposte

Nome	Tipo	Descrizione
200 OK	TransliterateResult[]	Successo
Other Status Codes	ErrorMessage	Risposta di errore.

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

Ocp-Apim-Subscription-Region

Tipo: apiKey
In: header

Esempio

Transliterate success example

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

200

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

Definizioni

Nome	Descrizione
Error
ErrorMessage
TransliterateResult	Esempio di richiesta di traslitterazione riuscita
TransliterateTextInput	Testo necessario per una richiesta traslitterare

Error

Object

Nome	Tipo	Descrizione
code	string
message	string

ErrorMessage

Object

Nome	Tipo	Descrizione
error	Error

TransliterateResult

Object

Esempio di richiesta di traslitterazione riuscita

Nome	Tipo	Descrizione
script	string
text	string

TransliterateTextInput

Object

Testo necessario per una richiesta traslitterare

Nome	Tipo	Descrizione
text	string