Container: Transkribera text
Konvertera tecken eller bokstäver i ett källspråk till motsvarande tecken eller bokstäver i ett målspråk.
Begärans-URL
POST
begäran:
POST http://localhost:{port}/transliterate?api-version=3.0&language={language}&fromScript={fromScript}&toScript={toScript}
Se Stöd för virtuellt nätverk för Translator-tjänsten valt nätverk och privat slutpunktskonfiguration och support.
Parametrar för begäran
Begärandeparametrar som skickas på frågesträngen är:
Frågeparameter | beskrivning | Villkor |
---|---|---|
api-version | Version av API:et som begärs av klienten. Värdet måste vara 3.0 . |
Obligatorisk parameter |
språk | Anger källspråket för texten som ska konverteras från ett skript till ett annat. | Obligatorisk parameter |
fromScript | Anger skriptet som används av indatatexten. | Obligatorisk parameter |
toScript | Anger utdataskriptet. | Obligatorisk parameter |
- Du kan fråga tjänsten om
transliteration
omfångsstödda språk. - Se även Språkstöd för transkribering.
Begärandehuvuden
Sidhuvuden | beskrivning | Villkor |
---|---|---|
Autentiseringshuvuden | Se tillgängliga alternativ för autentisering | Obligatoriskt begärandehuvud |
Innehållstyp | Anger nyttolastens innehållstyp. Möjligt värde: application/json |
Obligatoriskt begärandehuvud |
Innehållslängd | Längden på begärandetexten. | Valfritt |
X-ClientTraceId | Ett klientgenererat GUID för att unikt identifiera begäran. Du kan utelämna den här rubriken om du inkluderar spårnings-ID:t i frågesträngen med hjälp av en frågeparameter med namnet ClientTraceId . |
Valfritt |
Själva svaret
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 att konvertera indatasträngen till utdataskriptet.script
: En sträng som anger skriptet som används i utdata.
Svarsrubriker
Sidhuvuden | beskrivning |
---|---|
X-RequestId | Värde som genereras av tjänsten för att identifiera begäran. Den kan användas i felsökningssyfte. |
Exempelbegäran
curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn"
Exempelbegärantext
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.
[
{"Text":"こんにちは"},
{"Text":"さようなら"}
]
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 blanksteg.
JSON-exempelsvar:
[
{
"text": "Kon'nichiwa",
"script": "Latn"
},
{
"text": "sayonara",
"script": "Latn"
}
]
Kommentar
- Varje exempel körs på det
localhost
som du angav meddocker run
kommandot . - När containern körs
localhost
pekar den på själva containern. - Du behöver inte använda
localhost:5000
. Du kan använda alla portar som inte redan används i värdmiljön.
Transkribera med REST API
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':'さようなら'}]"