Egyéni fordítások definiálása

  • 5 perc

Bár az Azure AI Translator által használt alapértelmezett fordítási modell hatékony az általános fordításhoz, előfordulhat, hogy olyan fordítási megoldást kell kidolgoznia azoknak a vállalatoknak vagy iparágaknak, amelyekben egyedi fordítást igénylő kifejezések vannak.

A probléma megoldásához létrehozhat egy egyéni modellt, amely leképezi saját forrás- és célkifejezéseit a fordításhoz. Egyéni modell létrehozásához használja a Custom Translator portált a következőre:

  1. Hozzon létre egy Azure AI Translator-erőforráshoz társított munkaterületet .
  2. Hozzon létre egy projektet.
  3. Töltse fel a betanítási adatfájlokat , és taníts be egy modellt.
  4. Tesztelje a modellt , és tegye közzé a modellt.
  5. Fordítási hívásokat kezdeményezhet az API-hoz.

Screenshot showing the Custom Translator portal.

Az egyéni modellhez egyedi kategóriaazonosító van hozzárendelve (a képernyőképen kiemelve), amelyet a kategóriaparaméter használatával az Azure AI Translator-erőforrásnak történő fordítással adhat meg, így az egyéni modell az alapértelmezett modell helyett a fordítást hajtja végre.

Az API elnevezése

Fordítás indításához post kérést kell küldenie a következő kérelem URL-címére:

https://api.cognitive.microsofttranslator.com/translate?api-version=3.0

A kérésnek tartalmaznia kell néhány paramétert:

  • api-version: Az API szükséges verziója.
  • to: A lefordítandó célnyelv. Például: to=fr francia.
  • category: A kategória azonosítója.

A kérésnek több szükséges fejlécet is tartalmaznia kell:

  • Ocp-Apim-Subscription-Key. Az ügyfélkulcs fejléce. For example: Ocp-Apim-Subscription-Key=<your-client-key>.
  • Content-Type. A hasznos adat tartalomtípusa. A szükséges formátum a következő: Content-Type: application/json; charset=UTF-8.

A kérelem törzsének tartalmaznia kell egy olyan tömböt, amely tartalmaz egy JSON-objektumot egy Text olyan tulajdonsággal, amely meghatározza a lefordítani kívánt szöveget:

[
    {"Text":"Where can I find my employee details?"}
]

A kérést többféleképpen is elküldheti az API-nak, például a C#, a Python és a curl használatával. Ha például gyors hívást szeretne kezdeményezni, post kérést küldhet a curl használatával:

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=nl&category=<category-id>" -H "Ocp-Apim-Subscription-Key: <your-key" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Where can I find my employee details?'}]"

A fenti kérés egy mondat angolról holland nyelvre történő fordítását kéri.

Válasz visszaadva

A válasz egy válaszkódot ad vissza, 200 amely jelzi, hogy a kérés sikeres volt-e. A lefordított szöveget tartalmazó válasz törzsét is visszaadja, például a következőt:

[
    {
        "translations":[
            {"text":"Waar vind ik mijn personeelsgegevens?","to":"nl"}
        ]
    }
]

Ha a kérés nem sikerült, a hiba típusától függően több különböző állapotkód is visszaadható, például 400 (hiányzó vagy érvénytelen lekérdezési paraméterek). A kódok teljes listáját és magyarázatát a válasz állapotkódjaiban találja.

Megjegyzés:

Az egyéni fordítással kapcsolatos további információkért tekintse meg a rövid útmutatót: Build, publish and translate with custom models.