Anpassa en språkmodell med Azure AI Video Indexer API

  • Artikel

Viktigt!

På grund av azure Media Services-tillbakadragandemeddelandet meddelar Azure AI Video Indexer att funktionsjusteringar för Azure AI Video Indexer har justerats. Mer information om vad detta innebär för ditt Azure AI Video Indexer-konto finns i Ändringar som rör tillbakadragning av Azure Media Service (AMS). Se guiden Förbereda för AMS-pensionering: VI-uppdatering och migrering.

Med Azure AI Video Indexer kan du skapa anpassade språkmodeller för att anpassa taligenkänning genom att ladda upp anpassningstext, nämligen text från domänen vars vokabulär du vill att motorn ska anpassa sig till. När du har tränat din modell identifieras nya ord som visas i anpassningstexten.

En detaljerad översikt och metodtips för anpassade språkmodeller finns i Anpassa en språkmodell med Azure AI Video Indexer.

Du kan använda API:er för Azure AI Video Indexer för att skapa och redigera anpassade språkmodeller i ditt konto, enligt beskrivningen i den här artikeln. Du kan också använda webbplatsen enligt beskrivningen i Anpassa språkmodell med azure AI Video Indexer-webbplatsen.

Skapa en språkmodell

Skapa ett språkmodell-API skapar en ny anpassad språkmodell i det angivna kontot. Du kan ladda upp filer för språkmodellen i det här anropet. Du kan också skapa språkmodellen här och ladda upp filer för modellen senare genom att uppdatera språkmodellen.

Kommentar

Du måste fortfarande träna modellen med dess aktiverade filer för modellen för att lära dig innehållet i dess filer. Anvisningar för att träna ett språk finns i nästa avsnitt.

Om du vill ladda upp filer som ska läggas till i språkmodellen måste du ladda upp filer i brödtexten med hjälp av FormData utöver att ange värden för de obligatoriska parametrarna ovan. Det finns två sätt att utföra den här uppgiften:

  • Nyckeln är filnamnet och värdet är txt-filen.
  • Nyckeln är filnamnet och värdet är en URL till txt-fil.

Response

Svaret innehåller metadata för den nyligen skapade språkmodellen tillsammans med metadata för var och en av modellens filer enligt formatet för det här exemplets JSON-utdata:

{
    "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äna en språkmodell

Träna ett språkmodell-API tränar en anpassad språkmodell i det angivna kontot med innehållet i filerna som laddades upp till och aktiverades i språkmodellen.

Kommentar

Du måste först skapa språkmodellen och ladda upp dess filer. Du kan ladda upp filer när du skapar språkmodellen eller genom att uppdatera språkmodellen.

Response

Svaret innehåller metadata för den nyligen tränade språkmodellen tillsammans med metadata för var och en av modellens filer enligt formatet för det här exemplets JSON-utdata:

{
    "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"
    }
    ]
}

Det returnerade id är ett unikt ID som används för att skilja mellan språkmodeller, medan languageModelId används både för att ladda upp en video för att indexera om och indexera om en video-API:er (även kallat i API:er för linguisticModelId upp- och omindexering av Azure AI Video Indexer).

Ta bort en språkmodell

Api:et ta bort en språkmodell tar bort en anpassad språkmodell från det angivna kontot. Alla videor som använde den borttagna språkmodellen behåller samma index tills du indexerar om videon. Om du indexerar om videon kan du tilldela videon en ny språkmodell. Annars använder Azure AI Video Indexer sin standardmodell för att indexera om videon.

Response

Det finns inget returnerat innehåll när språkmodellen har tagits bort.

Uppdatera en språkmodell

Uppdatera ett API för språkmodell uppdaterar en anpassad språkpersonsmodell i det angivna kontot.

Kommentar

Du måste redan ha skapat språkmodellen. Du kan använda det här anropet för att aktivera eller inaktivera alla filer under modellen, uppdatera namnet på språkmodellen och ladda upp filer som ska läggas till i språkmodellen.

Om du vill ladda upp filer som ska läggas till i språkmodellen måste du ladda upp filer i brödtexten med hjälp av FormData utöver att ange värden för de obligatoriska parametrarna ovan. Det finns två sätt att utföra den här uppgiften:

  • Nyckeln är filnamnet och värdet är txt-filen.
  • Nyckeln är filnamnet och värdet är en URL till txt-fil.

Response

Svaret innehåller metadata för den nyligen tränade språkmodellen tillsammans med metadata för var och en av modellens filer enligt formatet för det här exemplets JSON-utdata:

{
    "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"
    }
    ]
}

Använd filerna id som returneras i svaret för att ladda ned innehållet i filen.

Uppdatera en fil från en språkmodell

Med uppdateringen av en fil kan du uppdatera namnet och enable tillståndet för en fil i en anpassad språkmodell i det angivna kontot.

Response

Svaret innehåller metadata för filen som du uppdaterade enligt formatet för JSON-exempelutdata nedan.

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

Använd filen id som returneras i svaret för att ladda ned innehållet i filen.

Hämta en specifik språkmodell

Get-API:et returnerar information om den angivna språkmodellen i det angivna kontot, till exempel språk och filer som finns i språkmodellen.

Response

Svaret innehåller metadata för den angivna språkmodellen tillsammans med metadata för var och en av modellens filer enligt formatet för det här exemplets JSON-utdata:

{
    "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"
    }
    ]
}

Använd filen id som returneras i svaret för att ladda ned innehållet i filen.

Hämta alla språkmodeller

Hämta alla API returnerar alla anpassade språkmodeller i det angivna kontot i en lista.

Response

Svaret innehåller en lista över alla språkmodeller i ditt konto och var och en av deras metadata och filer enligt formatet för det här exemplets JSON-utdata:

[
    {
        "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": []
    }
]

Ta bort en fil från en språkmodell

Borttagnings-API:et tar bort den angivna filen från den angivna språkmodellen i det angivna kontot.

Response

Det finns inget returnerat innehåll när filen tas bort från språkmodellen.

Hämta metadata för en fil från en språkmodell

Hämta metadata för ett fil-API returnerar innehållet i och metadata för den angivna filen från den valda språkmodellen i ditt konto.

Response

Svaret innehåller innehållet och metadata för filen i JSON-format, ungefär som i det här exemplet:

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

Kommentar

Innehållet i den här exempelfilen är orden "hello" och world på två separata rader.

Ladda ned en fil från en språkmodell

Ladda ned ett fil-API laddar ned en textfil som innehåller innehållet i den angivna filen från den angivna språkmodellen i det angivna kontot. Den här textfilen ska matcha innehållet i textfilen som ursprungligen laddades upp.

Response

Svaret är nedladdningen av en textfil med innehållet i filen i JSON-format.