Installera AZURE AI Vision 3.2 GA Read OCR-container

Artikel
09/02/2024

Med containrar kan du köra Api:er för Azure AI Vision i din egen miljö och kan hjälpa dig att uppfylla specifika krav för säkerhets- och datastyrning. I den här artikeln får du lära dig hur du laddar ned, installerar och kör OCR-containern (Azure AI Vision Read).

Med containern Läs kan du extrahera tryckt och handskriven text från bilder och dokument i JPEG-, PNG-, BMP-, PDF- och TIFF-filformat. Mer information om lästjänsten finns i guiden Läs API-instruktioner.

Nyheter

GA-versionen 3.2-model-2022-04-30 av Read-containern är tillgänglig med stöd för 164 språk och andra förbättringar. Om du är en befintlig kund följer du nedladdningsinstruktionerna för att komma igång.

Ocr-containern Read 3.2 är den senaste GA-modellen och tillhandahåller:

Nya modeller för förbättrad noggrannhet.
Stöd för flera språk i samma dokument.
Stöd för totalt 164 språk. Se den fullständiga listan över OCR-språk som stöds.
En enda åtgärd för både dokument och bilder.
Stöd för större dokument och bilder.
Förtroendepoäng.
Stöd för dokument med både utskrift och handskriven text.
Möjlighet att extrahera text från endast markerade sidor i ett dokument.
Välj textradens utdataordning från standard till en mer naturlig läsordning endast för latinska språk.
Textradsklassificering som handskriven stil eller inte endast för latinska språk.

Om du använder containern Read 2.0 i dag kan du läsa migreringsguiden för att lära dig mer om ändringar i de nya versionerna.

Förutsättningar

Du måste uppfylla följande krav innan du använder containrarna:

Obligatoriskt	Syfte
Docker-motorn	Du behöver Docker-motorn installerad på en värddator. Docker innehåller paket som konfigurerar Docker-miljön på macOS, Windows och Linux. En introduktion till grunderna för Docker och containrar finns i Docker-översikt. Docker måste konfigureras så att containrarna kan ansluta till och skicka faktureringsdata till Azure. I Windows måste Docker också konfigureras för att stödja Linux-containrar.
Kunskaper om Docker	Du bör ha en grundläggande förståelse för Docker-begrepp, till exempel register, lagringsplatser, containrar och containeravbildningar, samt kunskaper om grundläggande `docker` kommandon.
Visuellt innehåll resurs	För att kunna använda containern måste du ha: En Visuellt innehåll resurs och den associerade API-nyckeln till slutpunkts-URI:n. Båda värdena är tillgängliga på sidorna Översikt och Nycklar för resursen och krävs för att starta containern. {API_KEY}: En av de två tillgängliga resursnycklarna på sidan Nycklar {ENDPOINT_URI}: Slutpunkten enligt beskrivningen på översiktssidan

Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

Samla in obligatoriska parametrar

Tre primära parametrar för alla Azure AI-containrar krävs. Licensvillkoren för Programvara från Microsoft måste finnas med värdet accept. En slutpunkts-URI och API-nyckel behövs också.

Slutpunkts-URI

Värdet {ENDPOINT_URI} är tillgängligt på sidan Azure Portal Översikt för motsvarande Azure AI-tjänstresurs. Gå till sidan Översikt , hovra över slutpunkten och ikonen Kopiera till Urklipp visas. Kopiera och använd slutpunkten där det behövs.

Skärmbild som visar insamling av slutpunkts-URI för senare användning.

Nycklar

Värdet {API_KEY} används för att starta containern och är tillgängligt på sidan Azure Portal nycklar för motsvarande Azure AI-tjänstresurs. Gå till sidan Nycklar och välj ikonen Kopiera till Urklipp.

Skärmbild som visar hur du hämtar en av de två nycklarna för senare användning.

Viktigt!

Dessa prenumerationsnycklar används för att komma åt ditt Azure AI-tjänst-API. Dela inte dina nycklar. Lagra dem på ett säkert sätt. Använd till exempel Azure Key Vault. Vi rekommenderar också att du återskapar dessa nycklar regelbundet. Endast en nyckel krävs för att göra ett API-anrop. När du återskapar den första nyckeln kan du använda den andra nyckeln för fortsatt åtkomst till tjänsten.

Krav för värddator

Värden är en x64-baserad dator som kör Docker-containern. Det kan vara en dator lokalt eller en Docker-värdtjänst i Azure, till exempel:

Azure Kubernetes Service.
Azure Container Instances.
Ett Kubernetes-kluster som distribuerats till Azure Stack. Mer information finns i Distribuera Kubernetes till Azure Stack.

Stöd för Avancerat vektortillägg

Värddatorn är den dator som kör Docker-containern. Värden måste ha stöd för Advanced Vector Extensions (AVX2). Du kan söka efter STÖD för AVX2 på Linux-värdar med följande kommando:

grep -q avx2 /proc/cpuinfo && echo AVX2 supported || echo No AVX2 support detected

Varning

Värddatorn krävs för att stödja AVX2. Containern fungerar inte korrekt utan stöd för AVX2.

Krav och rekommendationer för containrar

Kommentar

Kraven och rekommendationerna baseras på riktmärken med en enda begäran per sekund, med en bild på 523 KB av en skannad företagsbokstav som innehåller 29 rader och totalt 803 tecken. Den rekommenderade konfigurationen resulterade i ungefär 2x snabbare svar jämfört med den minsta konfigurationen.

I följande tabell beskrivs den minsta och rekommenderade allokeringen av resurser för varje READ OCR-container.

Container	Lägsta	Rekommenderas
Läs 3.2 2022-04-30	4 kärnor, 8 GB minne	8 kärnor, 16 GB minne
Läs 3.2 2021-04-12	4 kärnor, 16 GB minne	8 kärnor, 24 GB minne

Varje kärna måste vara minst 2,6 gigahertz (GHz) eller snabbare.

Kärna och minne motsvarar --cpus inställningarna och --memory som används som en del av docker run kommandot.

Hämta containeravbildningen

Azure AI Vision Read OCR-containeravbildningen finns i mcr.microsoft.com containerregistersyndikatet. Den finns på lagringsplatsen azure-cognitive-services och heter read. Det fullständigt kvalificerade containeravbildningsnamnet är , mcr.microsoft.com/azure-cognitive-services/vision/read.

Om du vill använda den senaste versionen av containern kan du använda taggen latest . Du hittar också en fullständig lista över taggar på MCR.

Följande containeravbildningar för Read är tillgängliga.

Container	Container Registry/Lagringsplats/Avbildningsnamn	Taggar
Läs 3.2 GA	`mcr.microsoft.com/azure-cognitive-services/vision/read:3.2-model-2022-04-30`	senaste, 3.2, 3.2-model-2022-04-30

docker pull Använd kommandot för att ladda ned en containeravbildning.

docker pull mcr.microsoft.com/azure-cognitive-services/vision/read:3.2-model-2022-04-30

Dricks

Du kan använda kommandot docker images för att visa en lista över dina nedladdade containeravbildningar. Följande kommando visar till exempel ID, lagringsplats och tagg för varje nedladdad containeravbildning, formaterad som en tabell:

docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

IMAGE ID         REPOSITORY                TAG
<image-id>       <repository-path/name>    <tag-name>

Så här använder du containern

När containern finns på värddatorn använder du följande process för att arbeta med containern.

Kör containern med de faktureringsinställningar som krävs. Fler exempel på docker run kommandot är tillgängliga.
Fråga containerns förutsägelseslutpunkt.

Kör containern

Använd kommandot docker run för att köra containern. Mer information om hur du hämtar {ENDPOINT_URI} värdena och {API_KEY} finns i samla in obligatoriska parametrar.

Exempel på docker run kommandot är tillgängliga.

docker run --rm -it -p 5000:5000 --memory 16g --cpus 8 \
mcr.microsoft.com/azure-cognitive-services/vision/read:3.2-model-2022-04-30 \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Kommandot ovan:

Kör den senaste GA-containern read OCR från containeravbildningen.
Allokerar 8 CPU-kärnor och 16 gigabyte (GB) minne.
Exponerar TCP-port 5000 och allokerar en pseudo-TTY för containern.
Tar automatiskt bort containern när den har avslutats. Containeravbildningen är fortfarande tillgänglig på värddatorn.

Du kan också köra containern med hjälp av miljövariabler:

docker run --rm -it -p 5000:5000 --memory 16g --cpus 8 \
--env Eula=accept \
--env Billing={ENDPOINT_URI} \
--env ApiKey={API_KEY} \
mcr.microsoft.com/azure-cognitive-services/vision/read:3.2-model-2022-04-30

Fler exempel på docker run kommandot är tillgängliga.

Viktigt!

Alternativen Eula, Billingoch ApiKey måste anges för att köra containern. Annars startar inte containern. Mer information finns i Fakturering.

Om du använder Azure Storage för att lagra avbildningar för bearbetning kan du skapa en anslutningssträng som ska användas när du anropar containern.

Så här hittar du din anslutningssträng:

Gå till Lagringskonton på Azure Portal och leta reda på ditt konto.
Välj på Åtkomstnycklar i den vänstra navigeringslistan.
Din anslutningssträng kommer att finnas under anslutningssträngen

Köra flera containrar på samma värd

Om du tänker köra flera containrar med exponerade portar ska du köra varje container med en annan exponerad port. Kör till exempel den första containern på port 5000 och den andra containern på port 5001.

Du kan ha den här containern och en annan Azure AI-tjänstcontainer som körs på VÄRDEN tillsammans. Du kan också ha flera containrar av samma Azure AI-tjänstcontainer som körs.

Verifiera att en container körs

Det finns flera sätt att verifiera att containern körs. Leta upp den externa IP-adressen och den exponerade porten för containern i fråga och öppna din favoritwebbläsare. Använd de olika url:er för begäranden som följer för att verifiera att containern körs. Exempelbegärande-URL:er som anges här är http://localhost:5000, men din specifika container kan variera. Se till att förlita dig på containerns externa IP-adress och exponerade port.

Begärans-URL	Syfte
`http://localhost:5000/`	Containern tillhandahåller en startsida.
`http://localhost:5000/ready`	Den här URL:en begärs med GET och tillhandahåller en verifiering av att containern är redo att acceptera en fråga mot modellen. Den här begäran kan användas för Kubernetes liveness- och beredskapsavsökningar.
`http://localhost:5000/status`	Den här URL:en begärs också med GET och kontrollerar om api-nyckeln som används för att starta containern är giltig utan att orsaka en slutpunktsfråga. Den här begäran kan användas för Kubernetes liveness- och beredskapsavsökningar.
`http://localhost:5000/swagger`	Containern tillhandahåller en fullständig uppsättning dokumentation för slutpunkterna samt en Prova-funktion. Med den här funktionen kan du ange inställningarna i ett webbaserat HTML-formulär och göra frågan utan att behöva skriva någon kod. När frågan har returnerats tillhandahålls ett exempel på CURL-kommandot för att demonstrera de HTTP-huvuden och brödtextformat som krävs.

Containerns startsida

Köra frågor mot containerns förutsägelseslutpunkt

Containern innehåller REST-baserade slutpunkts-API:er för frågeförutsägelse.

Använd värden, http://localhost:5000, för container-API:er. Du kan visa Swagger-sökvägen på: http://localhost:5000/swagger/.

Asynkron läsning

Du kan använda POST /vision/v3.2/read/analyze åtgärderna och GET /vision/v3.2/read/operations/{operationId} tillsammans för att asynkront läsa en bild, ungefär som hur Azure AI Vision-tjänsten använder motsvarande REST-åtgärder. Den asynkrona POST-metoden returnerar en operationId som används som identifierare till HTTP GET-begäran.

I swagger-användargränssnittet väljer du Analyze för att expandera det i webbläsaren. Välj sedan Prova Välj>fil. I det här exemplet använder vi följande bild:

flikar jämfört med blanksteg

När den asynkrona POST har körts returnerar den en HTTP 202-statuskod . Som en del av svaret finns det en operation-location rubrik som innehåller resultatslutpunkten för begäran.

 content-length: 0
 date: Fri, 04 Sep 2020 16:23:01 GMT
 operation-location: http://localhost:5000/vision/v3.2/read/operations/a527d445-8a74-4482-8cb3-c98a65ec7ef9
 server: Kestrel

operation-location är den fullständigt kvalificerade URL:en och nås via en HTTP GET. Här är JSON-svaret från att operation-location köra URL:en från föregående bild:

{
  "status": "succeeded",
  "createdDateTime": "2021-02-04T06:32:08.2752706+00:00",
  "lastUpdatedDateTime": "2021-02-04T06:32:08.7706172+00:00",
  "analyzeResult": {
    "version": "3.2.0",
    "readResults": [
      {
        "page": 1,
        "angle": 2.1243,
        "width": 502,
        "height": 252,
        "unit": "pixel",
        "lines": [
          {
            "boundingBox": [
              58,
              42,
              314,
              59,
              311,
              123,
              56,
              121
            ],
            "text": "Tabs vs",
            "appearance": {
              "style": {
                "name": "handwriting",
                "confidence": 0.96
              }
            },
            "words": [
              {
                "boundingBox": [
                  68,
                  44,
                  225,
                  59,
                  224,
                  122,
                  66,
                  123
                ],
                "text": "Tabs",
                "confidence": 0.933
              },
              {
                "boundingBox": [
                  241,
                  61,
                  314,
                  72,
                  314,
                  123,
                  239,
                  122
                ],
                "text": "vs",
                "confidence": 0.977
              }
            ]
          },
          {
            "boundingBox": [
              286,
              171,
              415,
              165,
              417,
              197,
              287,
              201
            ],
            "text": "paces",
            "appearance": {
              "style": {
                "name": "handwriting",
                "confidence": 0.746
              }
            },
            "words": [
              {
                "boundingBox": [
                  286,
                  179,
                  404,
                  166,
                  405,
                  198,
                  290,
                  201
                ],
                "text": "paces",
                "confidence": 0.938
              }
            ]
          }
        ]
      }
    ]
  }
}

Viktigt!

Om du distribuerar flera Read OCR-containrar bakom en lastbalanserare, till exempel under Docker Compose eller Kubernetes, måste du ha en extern cache. Eftersom bearbetningscontainern och GET-begärandecontainern kanske inte är samma, lagrar en extern cache resultatet och delar dem mellan containrar. Mer information om cacheinställningar finns i Konfigurera Azure AI Vision Docker-containrar.

Synkron läsning

Du kan använda följande åtgärd för att synkront läsa en bild.

POST /vision/v3.2/read/syncAnalyze

När avbildningen läss i sin helhet returnerar API:et sedan ett JSON-svar. Det enda undantaget för det här beteendet är om ett fel inträffar. Om ett fel uppstår returneras följande JSON:

{
    "status": "Failed"
}

JSON-svarsobjektet har samma objektdiagram som den asynkrona versionen. Om du är JavaScript-användare och vill ha typsäkerhet bör du överväga att använda TypeScript för att omvandla JSON-svaret.

Ett exempel på användningsfall finns i sandbox-miljön i TypeScript här och välj Kör för att visualisera dess användarvänlighet.

Kör containern frånkopplad från Internet

Om du vill använda den här containern frånkopplad från Internet måste du först begära åtkomst genom att fylla i ett program och köpa en åtagandeplan. Mer information finns i Använda Docker-containrar i frånkopplade miljöer .

Om du har godkänts för att köra containern frånkopplad från Internet använder du följande exempel som visar formateringen för det docker run kommando som du ska använda, med platshållarvärden. Ersätt dessa platshållarvärden med dina egna värden.

Parametern DownloadLicense=True i kommandot docker run laddar ned en licensfil som gör att Docker-containern kan köras när den inte är ansluten till Internet. Den innehåller också ett förfallodatum, varefter licensfilen är ogiltig för att köra containern. Du kan bara använda en licensfil med lämplig container som du har godkänts för. Du kan till exempel inte använda en licensfil för en tal-till-text-container med en dokumentinformationscontainer.

Platshållare	Värde	Format eller exempel
`{IMAGE}`	Den containeravbildning som du vill använda.	`mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice`
`{LICENSE_MOUNT}`	Sökvägen där licensen laddas ned och monteras.	`/host/license:/path/to/license/directory`
`{ENDPOINT_URI}`	Slutpunkten för att autentisera din tjänstbegäran. Du hittar den på resursens nyckel- och slutpunktssida på Azure Portal.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{API_KEY}`	Nyckeln för din Textanalys resurs. Du hittar den på resursens nyckel- och slutpunktssida på Azure Portal.	`xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
`{CONTAINER_LICENSE_DIRECTORY}`	Plats för licensmappen i containerns lokala filsystem.	`/path/to/license/directory`

docker run --rm -it -p 5000:5000 \ 
-v {LICENSE_MOUNT} \
{IMAGE} \
eula=accept \
billing={ENDPOINT_URI} \
apikey={API_KEY} \
DownloadLicense=True \
Mounts:License={CONTAINER_LICENSE_DIRECTORY}

När licensfilen har laddats ned kan du köra containern i en frånkopplad miljö. I följande exempel visas formateringen för det docker run kommando som du ska använda, med platshållarvärden. Ersätt dessa platshållarvärden med dina egna värden.

Oavsett var containern körs måste licensfilen monteras på containern och platsen för licensmappen i containerns lokala filsystem måste anges med Mounts:License=. En utdatamontering måste också anges så att faktureringsanvändningsposter kan skrivas.

Platshållare	Värde	Format eller exempel
`{IMAGE}`	Den containeravbildning som du vill använda.	`mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice`
`{MEMORY_SIZE}`	Lämplig storlek på minne som ska allokeras för containern.	`4g`
`{NUMBER_CPUS}`	Lämpligt antal processorer som ska allokeras för din container.	`4`
`{LICENSE_MOUNT}`	Sökvägen där licensen ska finnas och monteras.	`/host/license:/path/to/license/directory`
`{OUTPUT_PATH}`	Utdatasökvägen för loggning av användningsposter.	`/host/output:/path/to/output/directory`
`{CONTAINER_LICENSE_DIRECTORY}`	Plats för licensmappen i containerns lokala filsystem.	`/path/to/license/directory`
`{CONTAINER_OUTPUT_DIRECTORY}`	Plats för utdatamappen i containerns lokala filsystem.	`/path/to/output/directory`

docker run --rm -it -p 5000:5000 --memory {MEMORY_SIZE} --cpus {NUMBER_CPUS} \ 
-v {LICENSE_MOUNT} \ 
-v {OUTPUT_PATH} \
{IMAGE} \
eula=accept \
Mounts:License={CONTAINER_LICENSE_DIRECTORY}
Mounts:Output={CONTAINER_OUTPUT_DIRECTORY}

Stoppa containern

Om du vill stänga av containern väljer du Ctrl+C i den kommandoradsmiljö där containern körs.

Felsökning

Om du kör containern med en utdatamontering och loggning aktiverad genererar containern loggfiler som är användbara för att felsöka problem som inträffar när containern startas eller körs.

Dricks

Mer felsökningsinformation och vägledning finns i Vanliga frågor och svar om Azure AI-containrar.

Om du har problem med att köra en Azure AI-tjänstcontainer kan du prova att använda Microsofts diagnostikcontainer. Använd den här containern för att diagnostisera vanliga fel i distributionsmiljön som kan förhindra att Azure AI-containrar fungerar som förväntat.

Använd följande docker pull kommando för att hämta containern:

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

Kör sedan containern. Ersätt {ENDPOINT_URI} med slutpunkten och ersätt {API_KEY} med nyckeln till resursen:

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Containern testar nätverksanslutningen till faktureringsslutpunkten.

Fakturering

Azure AI-containrarna skickar faktureringsinformation till Azure med hjälp av motsvarande resurs på ditt Azure-konto.

Frågor till containern faktureras på prisnivån för den Azure-resurs som används för parametern ApiKey .

Azure AI-tjänstcontainrar är inte licensierade att köras utan att vara anslutna till slutpunkten för mätning eller fakturering. Du måste aktivera containrarna för att kunna kommunicera faktureringsinformation med faktureringsslutpunkten hela tiden. Azure AI-tjänstcontainrar skickar inte kunddata, till exempel den bild eller text som analyseras, till Microsoft.

Ansluta till Azure

Containern behöver faktureringsargumentvärdena för att köras. Med de här värdena kan containern ansluta till faktureringsslutpunkten. Containern rapporterar användning var 10:e till 15:e minut. Om containern inte ansluter till Azure inom den tillåtna tidsperioden fortsätter containern att köras men hanterar inte frågor förrän faktureringsslutpunkten har återställts. Anslutningen görs 10 gånger med samma tidsintervall på 10 till 15 minuter. Om den inte kan ansluta till faktureringsslutpunkten inom de 10 försöken slutar containern att hantera begäranden. Se vanliga frågor och svar om Azure AI-tjänstcontainern för ett exempel på den information som skickas till Microsoft för fakturering.

Faktureringsargument

Kommandot docker run startar containern när alla tre av följande alternativ har giltiga värden:

Alternativ	Description
`ApiKey`	API-nyckeln för azure AI-tjänstresursen som används för att spåra faktureringsinformation. Värdet för det här alternativet måste anges till en API-nyckel för den etablerade resursen som anges i `Billing`.
`Billing`	Slutpunkten för azure AI-tjänstresursen som används för att spåra faktureringsinformation. Värdet för det här alternativet måste anges till slutpunkts-URI:n för en etablerad Azure-resurs.
`Eula`	Anger att du har godkänt licensen för containern. Värdet för det här alternativet måste vara inställt på att acceptera.

Mer information om de här alternativen finns i Konfigurera containrar.

Sammanfattning

I den här artikeln har du lärt dig begrepp och arbetsflöden för att ladda ned, installera och köra Azure AI Vision-containrar. Sammanfattningsvis:

Azure AI Vision tillhandahåller en Linux-container för Docker som kapslar in Read.
Läscontaineravbildningen kräver att ett program kör den.
Containeravbildningar körs i Docker.
Du kan använda rest-API:et eller SDK:n för att anropa åtgärder i Läs OCR-containrar genom att ange värd-URI:n för containern.
Du måste ange faktureringsinformation när du instansierar en container.

Viktigt!

Azure AI-containrar är inte licensierade att köras utan att vara anslutna till Azure för mätning. Kunder måste göra det möjligt för containrarna att kommunicera faktureringsinformation med mätningstjänsten hela tiden. Azure AI-containrar skickar inte kunddata (till exempel den bild eller text som analyseras) till Microsoft.

Nästa steg

Granska Konfigurera containrar för konfigurationsinställningar
Läs OCR-översikten om du vill veta mer om hur du känner igen tryckt och handskriven text
Mer information om de metoder som stöds av containern finns i läs-API:et.
Läs vanliga frågor och svar om du vill lösa problem som rör Azure AI Vision-funktioner.
Använda fler Azure AI-containrar

Dela via

Installera AZURE AI Vision 3.2 GA Read OCR-container

Nyheter

Förutsättningar

Samla in obligatoriska parametrar

Slutpunkts-URI

Nycklar

Krav för värddator

Stöd för Avancerat vektortillägg

Krav och rekommendationer för containrar

Hämta containeravbildningen

Så här använder du containern

Kör containern

Köra flera containrar på samma värd

Verifiera att en container körs

Köra frågor mot containerns förutsägelseslutpunkt

Asynkron läsning

Synkron läsning

Kör containern frånkopplad från Internet

Stoppa containern

Felsökning

Fakturering

Ansluta till Azure

Faktureringsargument

Sammanfattning

Nästa steg

Feedback

Ytterligare resurser