Installare ed eseguire il contenitore Traduttore di intelligenza artificiale di Azure

  • Articolo

Importante

  • Per usare il contenitore Traduttore, è necessario inviare una richiesta online e averla approvata. Per altre informazioni, vedereRichiedere l'accesso al contenitore.
  • Il contenitore Traduttore di intelligenza artificiale di Azure supporta funzionalità limitate rispetto alle offerte cloud.

I contenitori consentono di ospitare l'API Traduttore di intelligenza artificiale di Azure nella propria infrastruttura. L'immagine del contenitore include tutte le librerie, gli strumenti e le dipendenze necessarie per eseguire un'applicazione in modo coerente in qualsiasi ambiente privato, pubblico o personale. Se i requisiti di sicurezza o governance dei dati non possono essere soddisfatti chiamando l'API Traduttore di Intelligenza artificiale di Azure in modalità remota, i contenitori rappresentano un'ottima opzione.

Questo articolo illustra come installare ed eseguire il contenitore Traduttore online con l'API Docker. Il contenitore azure per intelligenza artificiale Traduttore supporta le operazioni seguenti:

  • Traduzione testuale. Tradurre il significato contestuale di parole o frasi dal supporto source alla lingua supportata target in tempo reale. Per altre informazioni, vedereContenitore: tradurre il testo.

  • 🆕 Traslitterazione del testo. Convertire il testo da uno script linguistico o scrivere un sistema in un altro script di linguaggio o scrivere il sistema in tempo reale. Per altre informazioni, vedereContenitore: traslitterare il testo.

  • 🆕 Traduzione dei documenti (anteprima). Tradurre in modo sincrono i documenti mantenendo in tempo reale la struttura e il formato. Per altre informazioni, vedereContainer:translate documents.

Prerequisiti

Per iniziare, sono necessarie le risorse, l'approvazione dell'accesso e gli strumenti seguenti:

Risorse di Azure

  • Una sottoscrizione di Azure attiva. Se non ne hai uno, puoi creare un account gratuito di 12 mesi.

  • Richiesta di accesso approvata a un contenitore connesso Traduttore o Traduttore contenitore disconnesso.

  • Una risorsa di azure per intelligenza artificiale Traduttore (non una risorsa dei servizi di intelligenza artificiale di Azure multiservizio) creata con l'ID sottoscrizione approvato. È necessaria la chiave API e l'URI dell'endpoint associati alla risorsa. Entrambi i valori sono necessari per avviare il contenitore e sono disponibili nella pagina di panoramica delle risorse nella portale di Azure.

    • Per Traduttore contenitori connessi, selezionare il S1 piano tariffario.

    • Per Traduttore contenitori disconnessi, selezionare Commitment tier disconnected containers come piano tariffario. Se la richiesta di accesso al contenitore disconnesso è approvata, viene visualizzata solo l'opzione per acquistare un livello di impegno.

      Screenshot che mostra la creazione di risorse nella portale di Azure.

Strumenti Docker

È necessario avere una conoscenza di base dei concetti di Docker, ad esempio registri, repository, contenitori e immagini del contenitore, nonché conoscenza della terminologia e dei comandi di base.docker Per una panoramica dei concetti fondamentali relativi a Docker e ai contenitori, vedere Docker overview (Panoramica di Docker).

Suggerimento

Prendere in considerazione l'aggiunta di Docker Desktop all'ambiente di elaborazione. Docker Desktop è un'interfaccia utente grafica (GUI) che consente di compilare, eseguire e condividere applicazioni in contenitori direttamente dal desktop.

DockerDesktop include il motore Docker, il client dell'interfaccia della riga di comando Docker, Docker Compose e fornisce pacchetti che configurano Docker per il sistema operativo preferito:

Strumento Descrizione Condizione
Docker Engine Il motore Docker è il componente principale della piattaforma di containerizzazione Docker. Deve essere installato in un computer host per consentire di compilare, eseguire e gestire i contenitori. Obbligatorio per tutte le operazioni.
Docker Compose Lo strumento Docker Compose viene usato per definire ed eseguire applicazioni multi-contenitore. Obbligatorio per supportare i contenitori.
Interfaccia della riga di comando di Docker L'interfaccia della riga di comando Docker consente di interagire con il motore Docker e di gestire i contenitori Docker direttamente dal computer locale. Consigliato
Requisiti del computer host

L'host è un computer basato su x64 che esegue il contenitore Docker. Può trattarsi di un computer locale o di uno di questi servizi di hosting Docker in Azure:

Sistema operativo Requisiti di sistema
Windows • Installato Windows 10 o Windows 11
• Processore a 64 bit
• Almeno 4 GB di RAM
• Funzionalità di Windows Hyper-V e Contenitore e virtualizzazione hardware a livello di BIOS
• Per altre informazioni, vedereInstallare Docker Desktop in Windows
Mac • Modello di computer 2010 o versione successiva
• Sistema operativo 10.13 o versione successiva
• Almeno 4 GB di RAM
• Per altre informazioni, vedereInstallare Docker Desktop in Mac
Linux • Versione a 64 bit di Ubuntu (versione LTS più recente (supporto a lungo termine) o versione corrente non LTS), Debian 12, Fedora 38 o Fedora 39
• Supporto della CPU per la virtualizzazione
• Almeno 4 GB di RAM
• Per altre informazioni, vedereInstallare Docker Desktop in Linux

Nota

Le specifiche minime e consigliate sono basate sui limiti di Docker, non sulle risorse del computer host.

La tabella seguente descrive le specifiche minime e consigliate e le transazioni consentite al secondo (TPS) per ogni contenitore.

Funzione Minimo consigliato Note
Traduzione testo 4 Core, 4 GB di memoria
Traslitterazione di testo 4 Core, 2 GB di memoria
Traduzione di documenti 4 Core, 6 GB di memoria Il numero di documenti che è possibile elaborare contemporaneamente può essere calcolato con la formula seguente: [minimo (n-2), (m-6)/4)].
• n è il numero di core CPU.
• m è GB di memoria.
• Esempio: 8 core, 32 GB di memoria può elaborare sei(6) documenti simultanei [minimo di (8-2), (36-6)/4)].

  • Ogni core deve essere di almeno 2,6 gigahertz (GHz) o superiore.

  • Per ogni coppia di lingue è consigliabile usare 2 GB di memoria.

  • Oltre ai requisiti di base, 4 GB di memoria per ogni elaborazione simultanea dei documenti.

    Suggerimento

    È possibile usare il comando docker images per visualizzare l'elenco delle immagini dei contenitori scaricate. Ad esempio, il comando seguente visualizza l'ID, il repository e il tag di ogni immagine del contenitore scaricata, in formato tabella:

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

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

Input richiesto

Tutti i contenitori di Intelligenza artificiale di Azure richiedono i valori di input seguenti:

  • Impostazione di accettazione del contratto di licenza. È necessario avere un contratto di licenza con l'utente finale impostato con il valore Eula=accept.

  • CHIAVE API e URL endpoint. La chiave API viene usata per avviare il contenitore. È possibile recuperare i valori della chiave API e dell'URL dell'endpoint passando alla pagina Azure AI Traduttore di risorse Chiavi ed endpoint e selezionando l'iconaCopy to clipboard.

  • Se si stanno traducendo documenti, assicurarsi di usare l'endpoint di traduzione dei documenti.

Importante

  • Le chiavi vengono usate per accedere alla risorsa di Intelligenza artificiale di Azure. Non condividerle. Archiviarli in modo sicuro, ad esempio usando Azure Key Vault.

  • È inoltre consigliabile rigenerare queste chiavi regolarmente. Per effettuare una chiamata API è necessaria una sola chiave. Quando si rigenera la prima chiave, è possibile usare la seconda chiave per l'accesso continuato al servizio.

Fatturazione

  • Le query al contenitore vengono fatturate al piano tariffario della risorsa di Azure usata per l'API Key.

  • Vengono addebitati i costi per ogni istanza del contenitore usata per elaborare documenti e immagini.

  • Il comando docker run scarica un'immagine da Registro artefatti Microsoft e avvia il contenitore quando vengono fornite tutte e tre le opzioni seguenti con valori validi:

Opzione Descrizione
ApiKey Chiave della risorsa dei servizi di intelligenza artificiale di Azure usata per tenere traccia delle informazioni di fatturazione.
Il valore di questa opzione deve essere impostato su una chiave per la risorsa di cui è stato effettuato il provisioning specificato in Billing.
Billing Endpoint della risorsa dei servizi di intelligenza artificiale di Azure usata per tenere traccia delle informazioni di fatturazione.
Il valore di questa opzione deve essere impostato sull'URI dell'endpoint di una risorsa di Azure di cui è stato effettuato il provisioning.
Eula Indica che è la licenza per il contenitore è stata accettata.
Il valore di questa opzione deve essere impostato su accept.

Connessione ad Azure

  • I valori dell'argomento di fatturazione del contenitore consentono al contenitore di connettersi all'endpoint di fatturazione ed eseguire.

  • Il contenitore segnala l'utilizzo ogni 10-15 minuti. Se il contenitore non si connette ad Azure entro l'intervallo di tempo consentito, il contenitore continua a essere eseguito, ma non esegue query finché non viene ripristinato l'endpoint di fatturazione.

  • Viene eseguito un tentativo di connessione 10 volte nello stesso intervallo di tempo compreso tra 10 e 15 minuti. Se non riesce a connettersi all'endpoint di fatturazione entro i 10 tentativi, il contenitore smette di gestire le richieste. Per un esempio delle informazioni inviate a Microsoft per la fatturazione, vedere domande frequenti sul contenitore di Intelligenza artificiale di Azure.

Immagini e tag del contenitore

Le immagini del contenitore dei servizi di intelligenza artificiale di Azure sono disponibili nel catalogo Registro artefatti Microsoft. Il contenitore Traduttore di intelligenza artificiale di Azure si trova all'interno del repository azure-cognitive-services/translator ed è denominato text-translation. Il nome completo dell'immagine del contenitore è mcr.microsoft.com/azure-cognitive-services/translator/text-translation:latest.

Per usare la versione più recente del contenitore, usare il tag più recente. È possibile visualizzare l'elenco completo dei tag di versione traduzione testuale dei servizi di intelligenza artificiale di Azure in MCR.

Usare i contenitori

Selezionare una scheda per scegliere l'ambiente contenitore Traduttore di intelligenza artificiale di Azure:

I contenitori di azure per intelligenza artificiale Traduttore consentono di eseguire il servizio on-premise azure per intelligenza artificiale Traduttore nel proprio ambiente. Connessione i contenitori eseguiti in locale e inviano informazioni sull'utilizzo al cloud per la fatturazione.

Scaricare ed eseguire l'immagine del contenitore

Il comando docker run scarica un'immagine da Registro artefatti Microsoft e avvia il contenitore.

Importante

  • I comandi di Docker nelle sezioni seguenti usano la barra rovesciata, \, come carattere di continuazione di riga. Sostituirla o rimuoverla in base ai requisiti del sistema operativo host.
  • È necessario specificare le opzioni EULA, Billing e ApiKey per eseguire il contenitore. In caso contrario, il contenitore non si avvia.
  • Se si stanno traducendo documenti, assicurarsi di usare l'endpoint di traduzione dei documenti.
docker run --rm -it -p 5000:5000 --memory 12g --cpus 4 \
-v /mnt/d/TranslatorContainer:/usr/local/models \
-e apikey={API_KEY} \
-e eula=accept \
-e billing={ENDPOINT_URI} \
-e Languages=en,fr,es,ar,ru  \
mcr.microsoft.com/azure-cognitive-services/translator/text-translation:latest

Il comando precedente:

  • Crea un contenitore di Traduttore in esecuzione da un'immagine del contenitore scaricata.
  • Alloca 12 gigabyte (GB) di memoria e quattro core CPU.
  • Espone la porta TCP (Transmission Control Protocol) 5000 e alloca uno pseudo-TTY per il contenitore. A questo punto, l'indirizzo localhost punta al contenitore stesso, non al computer host.
  • Accetta il contratto EULA (End-User Agreement).
  • Configura l'endpoint di fatturazione.
  • Scarica modelli di traduzione per lingue inglese, francese, spagnolo, arabo e russo.
  • Rimuove automaticamente il contenitore dopo la chiusura. L'immagine del contenitore rimane disponibile nel computer host.

Suggerimento

Comando Docker aggiuntivo:

  • docker ps elenca i contenitori in esecuzione.
  • docker pause {your-container name} sospende un contenitore in esecuzione.
  • docker unpause {your-container-name} rimuove un contenitore sospeso.
  • docker restart {your-container-name} riavvia un contenitore in esecuzione.
  • docker exec consente di eseguire i comandi lto detach o impostare le variabili di ambiente in un contenitore in esecuzione.

Per altre informazioni, vedere leinformazioni di riferimento sull'interfaccia della riga di comando di Docker.

Eseguire più contenitori nello stesso host

Se si intende eseguire più contenitori con porte esposte, assicurarsi di eseguire ogni contenitore con una porta esposta diversa. Eseguire ad esempio il primo contenitore sulla porta 5000 e il secondo sulla porta 5001.

È possibile avere questo contenitore e un contenitore di Intelligenza artificiale di Azure diverso in esecuzione nell'host insieme. È anche possibile avere più contenitori dello stesso contenitore di Azure per intelligenza artificiale in esecuzione.

Eseguire una query sull'endpoint del contenitore Traduttore

Il contenitore fornisce un'API endpoint basata su REST Traduttore. Ecco una richiesta di esempio con la lingua di origine (from=en) specificata:

  curl -X POST "http://localhost:5000/translate?api-version=3.0&from=en&to=zh-HANS" -H "Content-Type: application/json" -d "[{'Text':'Hello, what is your name?'}]"

Nota

  • Il rilevamento della lingua di origine richiede un contenitore aggiuntivo. Per altre informazioni, vedereSupporto dei contenitori

  • Se la richiesta cURL POST restituisce una Service is temporarily unavailable risposta, il contenitore non è pronto. Attendere alcuni minuti, quindi riprovare.

Verificare che il contenitore sia in esecuzione

Esistono diversi modi per verificare che il contenitore sia in esecuzione:

  • Il contenitore fornisce una home page in / come convalida visiva in cui è in esecuzione il contenitore.

  • È possibile aprire il Web browser preferito e passare all'indirizzo IP esterno e alla porta esposta del contenitore in questione. Usare gli URL di richiesta seguenti per verificare che il contenitore sia in esecuzione. Gli URL di richiesta di esempio elencati puntano a http://localhost:5000, ma il contenitore specifico può variare. Tenere presente che si passa all'indirizzo IP esterno del contenitore e alla porta esposta.

Richiesta URL Scopo
http://localhost:5000/ Il contenitore fornisce un home page.
http://localhost:5000/ready Richiesta con GET. Fornisce una verifica che il contenitore sia pronto per accettare una query sul modello. Questa richiesta può essere usata per i probe di attività e di idoneità di Kubernetes.
http://localhost:5000/status Richiesta con GET. Verifica se la chiave API usata per avviare il contenitore è valida senza causare una query dell'endpoint. Questa richiesta può essere usata per i probe di attività e di idoneità di Kubernetes.
http://localhost:5000/swagger Il contenitore fornisce un set completo di documentazione per gli endpoint e una funzionalità Prova. Con questa funzionalità, è possibile immettere le impostazioni in un modulo HTML basato sul Web ed eseguire la query senza scrivere codice. Al termine della query, viene fornito un comando CURL di esempio per illustrare le intestazioni HTTP e il formato del corpo necessari.

Screenshot della home page del contenitore.

Se si verificano problemi durante l'esecuzione di un contenitore di servizi di intelligenza artificiale di Azure, è possibile provare a usare il contenitore di diagnostica Microsoft. Usare questo contenitore per diagnosticare gli errori comuni nell'ambiente di distribuzione che potrebbero impedire il funzionamento dei contenitori di Intelligenza artificiale di Azure come previsto.

Per ottenere il contenitore, usare il comando seguente docker pull :

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

Eseguire quindi il contenitore. Sostituire {ENDPOINT_URI} con l'endpoint e sostituire {API_KEY} con la chiave alla risorsa:

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

Il contenitore verifica la connettività di rete all'endpoint di fatturazione.

Arrestare il contenitore

Per arrestare il contenitore, nell'ambiente della riga di comando in cui è in esecuzione il contenitore selezionare CTRL+C.

Casi d'uso per il supporto di contenitori

Alcune query Traduttore richiedono il supporto dei contenitori per completare correttamente le operazioni. Se si usano documenti di Office e non è necessario il rilevamento della lingua di origine, è necessario solo il contenitore Traduttore. Tuttavia, se è necessario il rilevamento della lingua di origine o si usano documenti PDF analizzati, sono necessari contenitori di supporto:

Nella tabella seguente sono elencati i contenitori di supporto necessari per le operazioni di traduzione di testo e documenti. Il contenitore Traduttore invia informazioni di fatturazione ad Azure tramite la risorsa Traduttore di intelligenza artificiale di Azure nell'account Azure.

Operazione Query di richiesta Tipo di documento Supporto dei contenitori
•Traduzione di testo
• Traduzione documenti		 from Specificato. Documenti di Office None
•Traduzione di testo
• Traduzione documenti		 from non specificato. Richiede il rilevamento automatico della lingua per determinare la lingua di origine. Documenti di Office ✔️ Analisi del testo: contenitore di linguaggio
•Traduzione di testo
• Traduzione documenti		 from Specificato. Documenti PDF analizzati Vision:read container ✔️
•Traduzione di testo
• Traduzione documenti		 from non specificato che richiede il rilevamento automatico della lingua per determinare la lingua di origine. Documenti PDF analizzati ✔️ Analisi del testo: contenitore di linguaggio

Vision:read container ✔️

Gestire i contenitori di supporto con docker compose

Docker compose è uno strumento che consente di configurare applicazioni multi-contenitore usando un singolo file YAML denominato compose.yamlin genere . Usare il comando per avviare l'applicazione docker compose up contenitore e il docker compose down comando per arrestare e rimuovere i contenitori.

Se è stata installata l'interfaccia della riga di comando di Docker Desktop, include Docker compose e i relativi prerequisiti. Se Docker Desktop non è disponibile, vedere la panoramica sull'installazione di Docker Compose.

Creare l'applicazione

  1. Usando l'editor o l'IDE preferito, creare una nuova directory per l'app denominata container-environment o un nome di propria scelta.

  2. Creare un nuovo file YAML denominato compose.yaml. Entrambe le estensioni .yml o yaml possono essere usate per il compose file.

  3. Copiare e incollare l'esempio di codice YAML seguente nel compose.yaml file. Sostituire {TRANSLATOR_KEY} e {TRANSLATOR_ENDPOINT_URI} con i valori della chiave e dell'endpoint dell'istanza di portale di Azure Traduttore. Se si stanno traducendo documenti, assicurarsi di usare .document translation endpoint

  4. Il nome di primo livello (azure-ai-translator, azure-ai-language, azure-ai-read) è il parametro specificato.

  5. container_name è un parametro facoltativo che imposta un nome per il contenitore durante l'esecuzione, anziché consentire docker compose la generazione di un nome.

    services:
  azure-ai-translator:
    container_name: azure-ai-translator
    image: mcr.microsoft.com/product/azure-cognitive-services/translator/text-translation:latest
    environment:
        - EULA=accept
        - billing={TRANSLATOR_ENDPOINT_URI}
        - apiKey={TRANSLATOR_KEY}
        - AzureAiLanguageHost=http://azure-ai-language:5000
        - AzureAiReadHost=http://azure-ai-read:5000
    ports:
          - "5000:5000"
    azure-ai-language:
      container_name: azure-ai-language
      image:  mcr.microsoft.com/azure-cognitive-services/textanalytics/language:latest
      environment:
          - EULA=accept
          - billing={TRANSLATOR_ENDPOINT_URI}
          - apiKey={TRANSLATOR_KEY}
    azure-ai-read:
      container_name: azure-ai-read
      image:  mcr.microsoft.com/azure-cognitive-services/vision/read:latest
      environment:
          - EULA=accept
          - billing={TRANSLATOR_ENDPOINT_URI}
          - apiKey={TRANSLATOR_KEY}

  6. Aprire un terminale passare alla container-environment cartella e avviare i contenitori con il comando seguente docker-compose :

    docker compose up

  7. Per arrestare i contenitori, usare il comando seguente:

    docker compose down

    Suggerimento

    Comandi Docker utili:

    • docker compose pause sospende i contenitori in esecuzione.
    • docker compose unpause {your-container-name} rimuove i contenitori sospesi.
    • docker compose restart riavvia tutti i contenitori arrestati ed in esecuzione con tutte le modifiche precedenti intatte. Se si apportano modifiche alla compose.yaml configurazione, queste modifiche non vengono aggiornate con il docker compose restart comando . È necessario usare il docker compose up comando per riflettere gli aggiornamenti e le modifiche nel compose.yaml file.
    • docker compose ps -a elenca tutti i contenitori, inclusi quelli arrestati.
    • docker compose execconsente di eseguire comandi per scollegare o impostare variabili di ambiente in un contenitore in esecuzione.

    Per altre informazioni, vedere leinformazioni di riferimento sull'interfaccia della riga di comando di Docker.

Traduttore e supportare immagini e tag del contenitore

Le immagini del contenitore dei servizi di intelligenza artificiale di Azure sono disponibili nel catalogo Registro artefatti Microsoft. La tabella seguente elenca il percorso completo dell'immagine per la traduzione di testo e documento:

Contenitore Posizione dell'immagine Note
Traduttore: Traduzione testuale e documento mcr.microsoft.com/azure-cognitive-services/translator/text-translation:latest È possibile visualizzare l'elenco completo dei tag di versione traduzione testuale dei servizi di intelligenza artificiale di Azure in MCR.
Analisi del testo: lingua mcr.microsoft.com/azure-cognitive-services/textanalytics/language:latest È possibile visualizzare l'elenco completo dei servizi di intelligenza artificiale di Azure Analisi del testo tag di versione del linguaggio in MCR.
Visione: lettura mcr.microsoft.com/azure-cognitive-services/vision/read:latest È possibile visualizzare l'elenco completo dei servizi di intelligenza artificiale di Azure Visione artificiale Leggere OCR i tag di versione in MCR.

Altri parametri e comandi

Ecco alcuni altri parametri e comandi che è possibile usare per eseguire il contenitore:

Record di utilizzo

Quando si operano contenitori Docker in un ambiente disconnesso, il contenitore scriverà i record di utilizzo in un volume in cui vengono raccolti nel tempo. È anche possibile chiamare un endpoint DELL'API REST per generare un report sull'utilizzo del servizio.

Argomenti per l'archiviazione dei log

Quando viene eseguito in un ambiente disconnesso, un montaggio di output deve essere disponibile per il contenitore per archiviare i log di utilizzo. Ad esempio, è necessario includere -v /host/output:{OUTPUT_PATH} e Mounts:Output={OUTPUT_PATH} nell'esempio seguente, sostituendo {OUTPUT_PATH} con il percorso in cui sono archiviati i log:

Comando di esempio docker run

docker run -v /host/output:{OUTPUT_PATH} ... <image> ... Mounts:Output={OUTPUT_PATH}

Nomi di variabili di ambiente nelle distribuzioni kubernetes

  • Alcuni contenitori di Intelligenza artificiale di Azure, ad esempio Traduttore, richiedono agli utenti di passare nomi di variabili di ambiente che includono i due punti (:) durante l'esecuzione del contenitore.

  • Kubernetes non accetta i due punti nei nomi delle variabili di ambiente. Per risolvere il problema, è possibile sostituire i due punti con due caratteri di sottolineatura (__) durante la distribuzione in Kubernetes. Vedere l'esempio seguente di un formato accettabile per i nomi delle variabili ambientali:

        env:
        - name: Mounts__License
          value: "/license"
        - name: Mounts__Output
          value: "/output"

In questo esempio viene sostituito il formato predefinito per i nomi delle Mounts:License variabili di ambiente e Mounts:Output nel comando docker run.

Ottenere i record di utilizzo usando gli endpoint del contenitore

Il contenitore fornisce due endpoint per la restituzione di record relativi all'utilizzo.

Ottenere tutti i record

L'endpoint seguente fornisce un report che riepiloga tutti gli utilizzi raccolti nella directory dei record di fatturazione montata.

https://<service>/records/usage-logs/

Endpoint HTTPS di esempio per recuperare tutti i record

http://localhost:5000/records/usage-logs

Ottenere record per un mese specifico

L'endpoint seguente fornisce un report che riepiloga l'utilizzo in un mese e un anno specifici:

https://<service>/records/usage-logs/{MONTH}/{YEAR}

Endpoint HTTPS di esempio per recuperare i record per un mese e un anno specifici

http://localhost:5000/records/usage-logs/03/2024

Gli endpoint usage-logs restituiscono una risposta JSON simile all'esempio seguente:

contenitore Connessione ed

quantity è l'importo addebitato per l'utilizzo del contenitore connesso.

{
"apiType": "string",
"serviceName": "string",
"meters": [
{
    "name": "string",
    "quantity": 256345435
    }
  ]
}

Contenitore disconnesso

      {
    "type": "CommerceUsageResponse",
    "meters": [
      {
        "name": "CognitiveServices.TextTranslation.Container.OneDocumentTranslatedCharacters",
        "quantity": 1250000,
        "billedUnit": 1875000
      },
      {
        "name": "CognitiveServices.TextTranslation.Container.TranslatedCharacters",
        "quantity": 1250000,
        "billedUnit": 1250000
      }
    ],
    "apiType": "texttranslation",
    "serviceName": "texttranslation"
   }

Il valore aggregato di billedUnit per i contatori seguenti viene conteggiato per i caratteri concessi in licenza per l'utilizzo del contenitore disconnesso:

  • CognitiveServices.TextTranslation.Container.OneDocumentTranslatedCharacters

  • CognitiveServices.TextTranslation.Container.TranslatedCharacters

Riepilogo

In questo articolo sono stati illustrati i concetti e i flussi di lavoro per il download, l'installazione e l'esecuzione di un contenitore di azure per intelligenza artificiale Traduttore:

  • Azure AI Traduttore contenitore supporta la traduzione testuale, la traduzione sincrona dei documenti e la traslitterazione di testo.

  • Le immagini del contenitore vengono scaricate dal registro contenitori ed eseguite in Docker.

  • Le informazioni di fatturazione devono essere specificate quando si crea un'istanza di un contenitore.

Passaggi successivi

Altre informazioni sulla configurazionedel contenitore di Intelligenza artificiale di Azure Sono disponibili altre informazioni sul supporto del linguaggio dei contenitori.