Dela via


Translator - Transliterate

Konverterar texten på ett språk i en skrift till en annan typ av skrift. Exempel - Japansk skrift "こんにちは" Samma ord i latinsk skrift "konnichiha"

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

URI-parametrar

Name I Obligatorisk Typ Description
Endpoint
path True

string

Cognitive Services-slutpunkter som stöds

api-version
query True

string

Version av API:et som begärs av klienten. Värdet måste vara 3,0.

fromScript
query True

string

Anger skriptet som används av indatatexten. Sök efter språk som stöds med hjälp av omfånget transliteration för att hitta indataskript som är tillgängliga för det valda språket.

language
query True

string

Anger språket för texten som ska konverteras från ett skript till ett annat. Möjliga språk visas i det omfång som transliteration erhålls genom att fråga tjänsten efter dess språk som stöds.

toScript
query True

string

Anger utdataskriptet. Sök efter språk som stöds med hjälp av omfånget transliteration för att hitta utdataskript som är tillgängliga för den valda kombinationen av indataspråk och indataskript.

Begärandehuvud

Name Obligatorisk Typ Description
X-ClientTraceId

string

Ett klientgenererat GUID för att unikt identifiera begäran. Observera att du kan utelämna det här huvudet om du inkluderar spårnings-ID:t i frågesträngen med hjälp av en frågeparameter med namnet ClientTraceId.

Begärandetext

Name Typ Description
texts

TransliterateTextInput[]

begäranens innehåll

Brödtexten i begäran är en JSON-matris. Varje matriselement är ett JSON-objekt med en strängegenskap med namnet Text, som representerar strängen som ska konverteras. Följande begränsningar gäller:

  • Matrisen kan ha högst 10 element.
  • Textvärdet för ett matriselement får inte överstiga 1 000 tecken, inklusive blanksteg.
  • Hela texten som ingår i begäran får inte överstiga 5 000 tecken inklusive mellanslag.

Svarsdel

Ett lyckat svar är en JSON-matris med ett resultat för varje element i indatamatrisen. Ett resultatobjekt innehåller följande egenskaper:

  • text- En sträng som är resultatet av konverteringen av indatasträngen till utdataskriptet.
  • script- En sträng som anger skriptet som används i utdata.

Svar

Name Typ Description
200 OK

TransliterateResult[]

Framgång

Other Status Codes

ErrorMessage

Felsvar.

Säkerhet

Ocp-Apim-Subscription-Key

Typ: apiKey
I: header

Ocp-Apim-Subscription-Key

Typ: apiKey
I: header

Ocp-Apim-Subscription-Region

Typ: apiKey
I: header

Exempel

Transliterate success example

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
Error
ErrorMessage
TransliterateResult

Exempel på en lyckad translitteratbegäran

TransliterateTextInput

Text som behövs för en translitteratbegäran

Error

Name Typ Description
code

string

message

string

ErrorMessage

Name Typ Description
error

Error

TransliterateResult

Exempel på en lyckad translitteratbegäran

Name Typ Description
script

string

text

string

TransliterateTextInput

Text som behövs för en translitteratbegäran

Name Typ Description
text

string