Přizpůsobení jazykového modelu pomocí rozhraní API služby Azure AI Video Indexer

  • Článek

Důležité

Vzhledem k oznámení o vyřazení služby Azure Media Services vám Azure AI Video Indexer oznámí úpravy funkcí Azure AI Video Indexeru. Informace o tom, co to znamená pro váš účet Azure AI Video Indexer, najdete v tématu Změny související s vyřazením služby Azure Media Service (AMS). Podívejte se na průvodce přípravou na vyřazení AMS: Průvodce aktualizací VI a migrací.

Azure AI Video Indexer umožňuje vytvářet vlastní jazykové modely pro přizpůsobení rozpoznávání řeči tím, že nahrajete adaptační text, konkrétně text z domény, jejíž slovní zásobu chcete, aby se modul přizpůsobil. Jakmile model vytrénujete, rozpozná se nová slova, která se zobrazí v textu pro přizpůsobení.

Podrobný přehled a osvědčené postupy pro vlastní jazykové modely najdete v tématu Přizpůsobení jazykového modelu pomocí Azure AI Video Indexeru.

Pomocí rozhraní API služby Azure AI Video Indexer můžete vytvářet a upravovat vlastní jazykové modely ve vašem účtu, jak je popsáno v tomto článku. Můžete také použít web, jak je popsáno v tématu Přizpůsobení jazykového modelu pomocí webu Azure AI Video Indexer.

Vytvoření jazykového modelu

Rozhraní API pro vytvoření jazykového modelu vytvoří nový vlastní jazykový model v zadaném účtu. V tomto volání můžete nahrát soubory pro jazykový model. Alternativně můžete zde vytvořit jazykový model a nahrát soubory pro model později aktualizací jazykového modelu.

Poznámka:

Abyste mohli zjistit obsah jeho souborů, musíte model stále trénovat s povolenými soubory. Pokyny k trénování jazyka najdete v další části.

Pokud chcete nahrát soubory, které se mají přidat do jazykového modelu, musíte kromě zadání hodnot požadovaných parametrů výše nahrát soubory do textu pomocí FormData. Tento úkol můžete provést dvěma způsoby:

  • Klíč je název souboru a hodnota je soubor txt.
  • Klíč je název souboru a hodnota je adresa URL souboru txt.

Response

Odpověď poskytuje metadata nově vytvořeného jazykového modelu spolu s metadaty pro každý soubor modelu ve formátu tohoto ukázkového výstupu JSON:

{
    "id": "dfae5745-6f1d-4edd-b224-42e1ab57a891",
    "name": "TestModel",
    "language": "En-US",
    "state": "None",
    "languageModelId": "00000000-0000-0000-0000-000000000000",
    "files": [
    {
        "id": "25be7c0e-b6a6-4f48-b981-497e920a0bc9",
        "name": "hellofile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-28T11:55:34.6733333"
    },
    {
        "id": "33025f5b-2354-485e-a50c-4e6b76345ca7",
        "name": "worldfile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-28T11:55:34.86"
    }
    ]
}

Trénování jazykového modelu

Vytrénování rozhraní API jazykového modelu trénuje vlastní jazykový model v zadaném účtu s obsahem v souborech, které byly odeslány do jazykového modelu a povoleny v tomto jazykovém modelu.

Poznámka:

Nejprve musíte vytvořit jazykový model a nahrát jeho soubory. Soubory můžete nahrát při vytváření jazykového modelu nebo aktualizací jazykového modelu.

Response

Odpověď poskytuje metadata nově natrénovaného jazykového modelu spolu s metadaty pro každý ze souborů modelu v následujícím formátu tohoto ukázkového výstupu JSON:

{
    "id": "41464adf-e432-42b1-8e09-f52905d7e29d",
    "name": "TestModel",
    "language": "En-US",
    "state": "Waiting",
    "languageModelId": "531e5745-681d-4e1d-b124-12e5ab57a891",
    "files": [
    {
        "id": "84fcf1ac-1952-48f3-b372-18f768eedf83",
        "name": "RenamedFile",
        "enable": false,
        "creator": "John Doe",
        "creationTime": "2018-04-27T20:10:10.5233333"
    },
    {
        "id": "9ac35b4b-1381-49c4-9fe4-8234bfdd0f50",
        "name": "hellofile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-27T20:10:10.68"
    }
    ]
}

id Vrácená hodnota je jedinečné ID používané k rozlišení mezi jazykovými modely, zatímco languageModelId se používá k nahrání videa k indexování a přeindexování rozhraní API videa (označované také jako linguisticModelId v rozhraních API pro nahrávání a přeindexování video indexeru Azure AI).

Odstranění jazykového modelu

Odstranění rozhraní API jazykového modelu odstraní z zadaného účtu vlastní jazykový model. Všechna videa, která používala odstraněný jazykový model, zachová stejný index, dokud video nepřeindexujete. Pokud video přeindexujete, můžete k videu přiřadit nový jazykový model. V opačném případě Azure AI Video Indexer použije k přeindexování videa výchozí model.

Response

Po úspěšném odstranění jazykového modelu neexistuje žádný vrácený obsah.

Aktualizace jazykového modelu

Aktualizace rozhraní API jazykového modelu aktualizuje vlastní model osoby jazyka v zadaném účtu.

Poznámka:

Jazykový model už musíte vytvořit. Pomocí tohoto volání můžete povolit nebo zakázat všechny soubory v modelu, aktualizovat název jazykového modelu a nahrát soubory, které se mají přidat do jazykového modelu.

Pokud chcete nahrát soubory, které se mají přidat do jazykového modelu, musíte kromě zadání hodnot požadovaných parametrů výše nahrát soubory do textu pomocí FormData. Tento úkol můžete provést dvěma způsoby:

  • Klíč je název souboru a hodnota je soubor txt.
  • Klíč je název souboru a hodnota je adresa URL souboru txt.

Response

Odpověď poskytuje metadata nově natrénovaného jazykového modelu spolu s metadaty pro každý ze souborů modelu v následujícím formátu tohoto ukázkového výstupu JSON:

{
    "id": "41464adf-e432-42b1-8e09-f52905d7e29d",
    "name": "TestModel",
    "language": "En-US",
    "state": "Waiting",
    "languageModelId": "531e5745-681d-4e1d-b124-12e5ab57a891",
    "files": [
    {
        "id": "84fcf1ac-1952-48f3-b372-18f768eedf83",
        "name": "RenamedFile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-27T20:10:10.5233333"
    },
    {
        "id": "9ac35b4b-1381-49c4-9fe4-8234bfdd0f50",
        "name": "hellofile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-27T20:10:10.68"
    }
    ]
}

id Pomocí souborů vrácených v odpovědi stáhněte obsah souboru.

Aktualizace souboru z jazykového modelu

Aktualizace souboru umožňuje aktualizovat název a enable stav souboru ve vlastním jazykovém modelu v zadaném účtu.

Response

Odpověď poskytuje metadata souboru, který jste aktualizovali podle formátu příkladu výstupu JSON níže.

{
  "id": "84fcf1ac-1952-48f3-b372-18f768eedf83",
  "name": "RenamedFile",
  "enable": false,
  "creator": "John Doe",
  "creationTime": "2018-04-27T20:10:10.5233333"
}

id Pomocí souboru vráceného v odpovědi stáhněte obsah souboru.

Získání konkrétního jazykového modelu

Rozhraní GET API vrátí informace o zadaném jazykovém modelu v zadaném účtu, jako je jazyk a soubory, které jsou v jazykovém modelu.

Response

Odpověď poskytuje metadata pro zadaný jazykový model spolu s metadaty pro každý ze souborů modelu v následujícím formátu tohoto ukázkového výstupu JSON:

{
    "id": "dfae5745-6f1d-4edd-b224-42e1ab57a891",
    "name": "TestModel",
    "language": "En-US",
    "state": "None",
    "languageModelId": "00000000-0000-0000-0000-000000000000",
    "files": [
    {
        "id": "25be7c0e-b6a6-4f48-b981-497e920a0bc9",
        "name": "hellofile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-28T11:55:34.6733333"
    },
    {
        "id": "33025f5b-2354-485e-a50c-4e6b76345ca7",
        "name": "worldfile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-28T11:55:34.86"
    }
    ]
}

id Pomocí souboru vráceného v odpovědi stáhněte obsah souboru.

Získání všech jazykových modelů

Získání všech rozhraní API vrátí všechny vlastní jazykové modely v zadaném účtu v seznamu.

Response

Odpověď poskytuje seznam všech jazykových modelů ve vašem účtu a všech jejich metadat a souborů ve formátu tohoto ukázkového výstupu JSON:

[
    {
        "id": "dfae5745-6f1d-4edd-b224-42e1ab57a891",
        "name": "TestModel",
        "language": "En-US",
        "state": "None",
        "languageModelId": "00000000-0000-0000-0000-000000000000",
        "files": [
        {
            "id": "25be7c0e-b6a6-4f48-b981-497e920a0bc9",
            "name": "hellofile",
            "enable": true,
            "creator": "John Doe",
            "creationTime": "2018-04-28T11:55:34.6733333"
        },
        {
            "id": "33025f5b-2354-485e-a50c-4e6b76345ca7",
            "name": "worldfile",
            "enable": true,
            "creator": "John Doe",
            "creationTime": "2018-04-28T11:55:34.86"
        }
        ]
    },
    {
        "id": "dfae5745-6f1d-4edd-b224-42e1ab57a892",
        "name": "AnotherTestModel",
        "language": "En-US",
        "state": "None",
        "languageModelId": "00000000-0000-0000-0000-000000000001",
        "files": []
    }
]

Odstranění souboru z jazykového modelu

Rozhraní API pro odstranění odstraní zadaný soubor ze zadaného jazykového modelu v zadaném účtu.

Response

Po úspěšném odstranění souboru z jazykového modelu neexistuje žádný vrácený obsah.

Získání metadat souboru z jazykového modelu

Získání metadat rozhraní API pro soubory vrátí obsah a metadata zadaného souboru ze zvoleného jazykového modelu ve vašem účtu.

Response

Odpověď poskytuje obsah a metadata souboru ve formátu JSON, podobně jako v tomto příkladu:

{
    "content": "hello\r\nworld",
    "id": "84fcf1ac-1952-48f3-b372-18f768eedf83",
    "name": "Hello",
    "enable": true,
    "creator": "John Doe",
    "creationTime": "2018-04-27T20:10:10.5233333"
}

Poznámka:

Obsah tohoto ukázkového souboru jsou slova "hello" a world ve dvou samostatných řádcích.

Stažení souboru z jazykového modelu

Stažení souborového rozhraní API stáhne textový soubor obsahující obsah zadaného souboru ze zadaného jazykového modelu v zadaném účtu. Tento textový soubor by se měl shodovat s obsahem textového souboru, který byl původně nahraný.

Response

Odpověď je stažení textového souboru s obsahem souboru ve formátu JSON.