Zahájení překladu

Pomocí tohoto rozhraní API můžete ve službě překladu dokumentů zahájit žádost o překlad. Každý požadavek může obsahovat více dokumentů a musí obsahovat zdrojový a cílový kontejner pro každý dokument.

Filtr předpon a přípon (pokud je zadaný) se používá k filtrování složek. Předpona se použije na dílčí cesta za názvem kontejneru.

Glosáře / Paměť překladu může být součástí požadavku a služba je použije při překladu dokumentu.

Pokud je glosář během překladu neplatný nebo nedostupný, ve stavu dokumentu se zobrazí chyba. Pokud v cíli již existuje soubor se stejným názvem, úloha selže. TargetUrl pro každý cílový jazyk musí být jedinečný.

Adresa URL požadavku

Odešlete POST požadavek na:

POST https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.0/batches

Zjistěte, jak najít vlastní název domény.

Hlavičky požadavku

Hlavičky požadavku jsou:

Text žádosti: Žádost o odeslání dávky

Vstupy

Definice pro vstupní požadavek dávkového překladu.

inputs.source

Zdroj vstupních dokumentů

inputs.storageType

Storage typu zdrojového řetězce vstupních dokumentů.

inputs.target

Cíl dokončených přeložených dokumentů

Příklad požadavku

Následují příklady požadavků Batch.

Překlad všech dokumentů v kontejneru

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?sv=2019-12-12&st=2021-03-05T17%3A45%3A25Z&se=2021-03-13T17%3A45%3A00Z&sr=c&sp=rl&sig=SDRPMjE4nfrH3csmKLILkT%2Fv3e0Q6SWpssuuQl1NmfM%3D"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?sv=2019-12-12&st=2021-03-05T17%3A49%3A02Z&se=2021-03-13T17%3A49%3A00Z&sr=c&sp=wdl&sig=Sq%2BYdNbhgbq4hLT0o1UUOsTnQJFU590sWYo4BOhhQhs%3D",
                    "language": "fr"
                }
            ]
        }
    ]
}

Překlad všech dokumentů v kontejneru s použitím Glossaries

Ujistěte se, že jste vytvořili adresu URL glosáře & token SAS pro konkrétní objekt BLOB nebo dokument (ne pro kontejner).

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?sv=2019-12-12&st=2021-03-05T17%3A45%3A25Z&se=2021-03-13T17%3A45%3A00Z&sr=c&sp=rl&sig=SDRPMjE4nfrH3csmKLILkT%2Fv3e0Q6SWpssuuQl1NmfM%3D"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?sv=2019-12-12&st=2021-03-05T17%3A49%3A02Z&se=2021-03-13T17%3A49%3A00Z&sr=c&sp=wdl&sig=Sq%2BYdNbhgbq4hLT0o1UUOsTnQJFU590sWYo4BOhhQhs%3D",
                    "language": "fr",
                    "glossaries": [
                        {
                            "glossaryUrl": "https://my.blob.core.windows.net/glossaries/en-fr.xlf?sv=2019-12-12&st=2021-03-05T17%3A45%3A25Z&se=2021-03-13T17%3A45%3A00Z&sr=c&sp=rl&sig=BsciG3NWoOoRjOYesTaUmxlXzyjsX4AgVkt2AsxJ9to%3D",
                            "format": "xliff",
                            "version": "1.2"
                        }
                    ]

                }
            ]
        }
    ]
}

Překlad konkrétní složky v kontejneru

Ujistěte se, že jste zadali název složky (rozlišuje velká a malá písmena) jako předponu ve filtru – i když je token SAS pro kontejner stále k dispozici.

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?sv=2019-12-12&st=2021-03-05T17%3A45%3A25Z&se=2021-03-13T17%3A45%3A00Z&sr=c&sp=rl&sig=SDRPMjE4nfrH3csmKLILkT%2Fv3e0Q6SWpssuuQl1NmfM%3D",
                "filter": {
                    "prefix": "MyFolder/"
                }
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?sv=2019-12-12&st=2021-03-05T17%3A49%3A02Z&se=2021-03-13T17%3A49%3A00Z&sr=c&sp=wdl&sig=Sq%2BYdNbhgbq4hLT0o1UUOsTnQJFU590sWYo4BOhhQhs%3D",
                    "language": "fr"
                }
            ]
        }
    ]
}

Překlad konkrétního dokumentu v kontejneru

• Ujistěte se, že jste zadali "storageType": "File"
• Ujistěte se, že jste vytvořili zdrojovou adresu URL & token SAS pro konkrétní objekt BLOB nebo dokument (ne pro kontejner).
• Ujistěte se, že jste zadali název cílového souboru jako součást cílové adresy URL – i když je token SAS pro kontejner stále k dispozici.
• Vzorový požadavek níže ukazuje jeden dokument, který je přeložen do dvou cílových jazyků.

{
    "inputs": [
        {
            "storageType": "File",
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en/source-english.docx?sv=2019-12-12&st=2021-01-26T18%3A30%3A20Z&se=2021-02-05T18%3A30%3A00Z&sr=c&sp=rl&sig=d7PZKyQsIeE6xb%2B1M4Yb56I%2FEEKoNIF65D%2Fs0IFsYcE%3D"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target/try/Target-Spanish.docx?sv=2019-12-12&st=2021-01-26T18%3A31%3A11Z&se=2021-02-05T18%3A31%3A00Z&sr=c&sp=wl&sig=AgddSzXLXwHKpGHr7wALt2DGQJHCzNFF%2F3L94JHAWZM%3D",
                    "language": "es"
                },
                {
                    "targetUrl": "https://my.blob.core.windows.net/target/try/Target-German.docx?sv=2019-12-12&st=2021-01-26T18%3A31%3A11Z&se=2021-02-05T18%3A31%3A00Z&sr=c&sp=wl&sig=AgddSzXLXwHKpGHr7wALt2DGQJHCzNFF%2F3L94JHAWZM%3D",
                    "language": "de"
                }
            ]
        }
    ]
}

Stavové kódy odpovědí

Níže jsou uvedené možné stavové kódy HTTP, které požadavek vrátí.

Chybová odezva

Příklady

Příklad úspěšné odpovědi

V úspěšné odpovědi se vrátí následující informace.

ID úlohy najdete v hlavičce odpovědi metody POST Operation-Location URL. Posledním parametrem adresy URL je ID úlohy operace (řetězec za /operation/).

Operation-Location: https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.0/operation/0FA2822F-4C2A-4317-9C20-658C801E0E55

Příklad chybové odpovědi

{
  "error": {
    "code": "ServiceUnavailable",
    "message": "Service is temporary unavailable",
    "innerError": {
      "code": "ServiceTemporaryUnavailable",
      "message": "Service is currently unavailable.  Please try again later"
    }
  }
}

Další kroky

Další informace o používání překladu dokumentů a klientské knihovny najdete v našem rychlém startu.