Introdução à Tradução de Documento
A Tradução de Documentos é um recurso baseado em nuvem do serviço Tradutor de Ia do Azure que traduz documentos inteiros de forma assíncrona nos idiomas com suporte e vários formatos de arquivo. Neste início rápido, você aprende a usar a Tradução de Documento com uma linguagem de programação de sua escolha para traduzir um documento de origem em um idioma de destino, preservando a estrutura e a formatação de texto.
Pré-requisitos
Importante
Atualmente, os SDKs de Tradução de Documentos Java e JavaScript estão disponíveis em versão preliminar pública. Recursos, abordagens e processos podem ser alterados, antes da versão de disponibilidade geral (GA), com base nos comentários do usuário.
Os SDKs do C# e do Python são versões de disponibilidade geral (GA) prontas para uso em seus aplicativos de produção
No entanto, atualmente, a Tradução de Documento tem suporte apenas no recurso do Tradutor (serviço único) e não está incluída no recurso dos serviços de IA do Azure (vários serviços).
A Tradução de Documentos só com suporte no plano de serviço Standard S1 (pago conforme o uso) ou no plano de desconto por volume D3. Confira Preços dos serviços de IA do Azure – Tradutor.
Para começar, você precisa do seguinte:
Uma conta do Azure ativa. Se você não tem uma, crie uma conta gratuita.
Uma conta de Armazenamento de Blobs do Azure. Você precisará criar contêineres na sua conta de armazenamento de blobs do Azure para os arquivos de origem e destino:
- Contêiner de origem. Esse contêiner é onde você carrega os arquivos para tradução (obrigatório).
- Contêiner de destino. Esse contêiner é o local em que os arquivos traduzidos são armazenados (obrigatório).
Um recurso de Tradução de serviço único (não um recurso de vários serviços dos serviços de IA do Azure):
Preencha os campos Tradutor detalhes do projeto e da instância da seguinte forma:
Assinatura. Selecione uma das suas assinaturas do Azure disponíveis.
Grupo de Recursos. Você pode criar um grupo de recursos ou adicionar o recurso a um grupo de recursos existente que compartilhe o mesmo ciclo de vida e as mesmas permissões e políticas.
Região do recurso. Escolha Global, a menos que seu negócio ou aplicativo exija uma região específica. Se você estiver planejando usar uma identidade gerenciada atribuída pelo sistema para autenticação, escolha uma região geográfica como Oeste dos EUA.
Nome.. Insira o nome escolhido para o recurso. O nome escolhido deve ser exclusivo dentro do Azure.
Observação
A Tradução de Documentos requer um ponto de extremidade de domínio personalizado. O valor que você inserir no campo Nome será o parâmetro de nome de domínio personalizado para o ponto de extremidade.
Tipo de preço. Não há suporte para a Tradução de Documentos na camada gratuita. Selecione Standard S1 para experimentar o serviço.
Selecione Examinar + criar.
Examine os termos de serviço e selecione Criar para implantar o seu recurso.
Depois que o recurso for implantado com êxito, selecione Ir para o recurso.
Recuperar sua chave e ponto de extremidade de tradução de documento
As solicitações para o Serviço de Tradução exigem uma chave somente leitura e um ponto de extremidade personalizado para autenticar o acesso. O ponto de extremidade do domínio personalizado é uma URL formatada com o nome do recurso, nome do host e os subdiretórios de Tradução e está disponível no portal do Azure.
Se você tiver criado um novo recurso, depois que ele for implantado, selecione Ir para o recurso. Se você tiver um recurso de Tradução de Documento existente, navegue diretamente para a página de recursos.
No trilho à esquerda, em Gerenciamento de Recursos, selecione Chaves e Ponto de Extremidade.
Você pode copiar e colar seus
key
edocument translation endpoint
nos exemplos de código para autenticar sua solicitação ao serviço de Tradução de Documentos. Apenas uma chave é necessária para fazer uma chamada à API.
Criar contêineres de armazenamento de blobs do Azure
Você precisa criar contêineres na sua conta de armazenamento de blobs do Azure para os arquivos de origem e destino.
- Contêiner de origem. Esse contêiner é onde você carrega os arquivos para tradução (obrigatório).
- Contêiner de destino. Esse contêiner é o local em que os arquivos traduzidos são armazenados (obrigatório).
Autenticação necessária
O contêineres sourceUrl
, targetUrl
e glossaryUrl
opcional devem incluir um token de SAS (Assinatura de Acesso Compartilhado), anexado como uma cadeia de caracteres de consulta. O token pode ser atribuído ao contêiner ou a blobs específicos. ConfiraCriar tokens SAS para o processo de Tradução de Documento.
- O contêiner ou o blob de origem deve ter acesso de leitura e lista designado.
- O contêiner ou blob de destino deve ter acesso de gravação e lista designados.
- O blob do glossário deve designar o acesso de leitura e lista.
Dica
- Se você estiver traduzindo vários arquivos (blobs) em uma operação, delegue acesso SAS no nível do contêiner.
- Se você estiver traduzindo um único arquivo (blob) em uma operação, delegue acesso SAS no nível do blob.
- Como alternativa aos tokens SAS, você pode usar uma identidade gerenciada atribuída pelo sistema para autenticação.
Exemplo de documento
Neste projeto, você precisa de um documento de origem carregado no contêiner de origem. Você pode baixar nosso documento de exemplo de tradução de documento para este início rápido. O idioma de origem é o inglês.
Configurar seu ambiente C#/.NET
Neste início rápido, usamos a versão mais recente do IDE do Visual Studio para compilar e executar o aplicativo.
Inicie o Visual Studio.
Na página Introdução, escolha Criar um projeto.
Na página Criar um projeto, insira console na caixa de pesquisa. Escolha o modelo Aplicativo de Console e selecione Avançar.
Na janela do diálogo Configurar seu novo projeto, insira
document-translation-qs
na caixa Nome do projeto. Em seguida, escolha Avançar.Na janela de diálogo Informações adicionais, selecione .NET 6.0 (Suporte de longo prazo) e escolha Criar.
Instalar o Newtonsoft.Json
Clique com o botão direito do mouse no projeto document-translation-qs e selecione Gerenciar Pacotes NuGet….
Selecione a guia Procurar e digite NewtonsoftJson.
Selecione a versão estável mais recente no menu suspenso e instale o pacote no projeto.
Traduzir todos os documentos em um contêiner de armazenamento
Observação
- A partir do .NET 6, os novos projetos que usam o modelo
console
geram um novo estilo de programa diferente das versões anteriores. - A nova saída usa recursos recentes do C# que simplificam a codificação.
- Ao usar a versão mais recente, você só precisa escrever o corpo do método
Main
. Você não precisa incluir instruções de nível superior, diretivas de uso globais nem diretivas de uso implícitas. - Para obter mais informações, consulte Novos modelos C# geram instruções de nível superior.
Abra o arquivo Program.cs.
Exclua o código preexistente, incluindo a linha
Console.WriteLine("Hello World!")
.Copiar e colar o código de exemplo da tradução de documento no arquivo Program.cs.
Atualizar
{your-document-translation-endpoint}
e{your-key}
com valores de sua instância de Tradução do portal do Azure.Atualizar
{your-source-container-SAS-URL}
e{your-target-container-SAS-URL}
com valores de sua instância de contêineres da conta de armazenamento do portal do Azure.
Exemplo de código
Importante
Lembre-se de remover a chave do seu código quando terminar e nunca poste-a publicamente. Para produção, use uma maneira segura de armazenar e acessar suas credenciais, como o Azure Key Vault. Para obter mais informações, consulte a segurança dos serviços de IA do Azure.
using System.Text;
class Program
{
private static readonly string endpoint = "{your-document-translator-endpoint}/translator/text/batch/v1.1";
private static readonly string key = "{your-key}";
static readonly string route = "/batches";
static readonly string sourceURL = "\" {your-source-container-SAS-URL}\"";
static readonly string targetURL = " \"{your-target-container-SAS-URL}\"";
static readonly string json = ("{\"inputs\": [{\"source\": {\"sourceUrl\":"+sourceURL+" ,\"storageSource\": \"AzureBlob\",\"language\": \"en\"}, \"targets\": [{\"targetUrl\":"+targetURL+",\"storageSource\": \"AzureBlob\",\"category\": \"general\",\"language\": \"es\"}]}]}");
static async Task Main(string[] args)
{
using HttpClient client = new HttpClient();
using HttpRequestMessage request = new HttpRequestMessage();
{
StringContent content = new StringContent(json, Encoding.UTF8, "application/json");
request.Method = HttpMethod.Post;
request.RequestUri = new Uri(endpoint + route);
request.Headers.Add("Ocp-Apim-Subscription-Key", key);
request.Content = content;
HttpResponseMessage response = await client.SendAsync(request);
string result = response.Content.ReadAsStringAsync().Result;
if (response.IsSuccessStatusCode)
{
Console.WriteLine($"Status code: {response.StatusCode}");
Console.WriteLine();
Console.WriteLine($"Response Headers:");
Console.WriteLine(response.Headers);
}
else
Console.Write("Error");
}
}
}
Execute seu aplicativo.
Depois de adicionar um exemplo de código ao seu aplicativo, escolha o botão verde Iniciar próximo de document-translation-qs para compilar e executar seu programa ou pressione F5.
Após a conclusão bem-sucedida:
- Os documentos traduzidos podem ser encontrados no seu contêiner de destino.
- O método POST bem-sucedido retorna um código de resposta
202 Accepted
indicando que o serviço criou a solicitação em lote. - A solicitação POST também retorna cabeçalhos de resposta, incluindo
Operation-Location
que fornece um valor usado em solicitações GET subsequentes.
Configurar o ambiente do Go
Você pode usar qualquer editor de texto para escrever aplicativos do Go. Recomendamos usar a última versão do Visual Studio Code e a extensão Go.
Dica
Caso não esteja familiarizado com o Go, experimente o módulo Introdução ao Go do Learn.
Caso não tenha feito isso ainda, baixe e instale o Go.
Baixe a versão do Go para seu sistema operacional.
Quando o download for concluído, execute o instalador.
Abra um prompt de comando e insira o seguinte para confirmar se o Go foi instalado:
go version
Traduzir todos os documentos em um contêiner de armazenamento
Em uma janela de console (como o cmd, o PowerShell ou o Bash), crie um diretório chamado document-translation-qs para seu aplicativo e navegue até ele.
Crie um novo arquivo Go chamado document-translation.go no diretório document-translation-qs.
Copiar e colar o código de exemplo da tradução de documento no arquivo document-translation.go.
Atualizar
{your-document-translation-endpoint}
e{your-key}
com valores de sua instância de Tradução do portal do Azure.Atualizar
{your-source-container-SAS-URL}
e{your-target-container-SAS-URL}
com valores de sua instância de contêineres da conta de armazenamento do portal do Azure.
Exemplo de código
Importante
Lembre-se de remover a chave do seu código quando terminar e nunca poste-a publicamente. Para produção, use uma maneira segura de armazenar e acessar suas credenciais, como o Azure Key Vault. Para obter mais informações, consulte a segurança dos serviços de IA do Azure.
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
httpposturl := "{your-document-translation-endpoint}/translator/text/batch/v1.1/batches"
fmt.Println("Response", httpposturl)
var jsonData = []byte(`{
"inputs": [
{
"source": {
"sourceUrl": "{your-source-container-SAS-URL}"
},
"targets": [
{
"{your-target-container-SAS-URL}",
"language": "fr"
}
]
}
]
}`)
request, error := http.NewRequest("POST", httpposturl, bytes.NewBuffer(jsonData))
request.Header.Set("Content-Type", "application/json")
request.Header.Set("Ocp-Apim-Subscription-Key", "{your-key}")
client := &http.Client{}
response, error := client.Do(request)
if error != nil {
panic(error)
}
defer response.Body.Close()
fmt.Println("response Status:", response.Status)
var printHeader = (response.Header)
prettyJSON, _ := json.MarshalIndent(printHeader, "", " ")
fmt.Printf("%s\n", prettyJSON)
}
Executar seu aplicativo Go
Depois que você adicionar um exemplo de código ao seu aplicativo, o programa Go poderá ser executado em um prompt de comando ou de terminal. Verifique se o caminho do prompt está definido para a pasta document-translation-qs e use o seguinte comando:
go run document-translation.go
Após a conclusão bem-sucedida:
- Os documentos traduzidos podem ser encontrados no seu contêiner de destino.
- O método POST bem-sucedido retorna um código de resposta
202 Accepted
indicando que o serviço criou a solicitação em lote. - A solicitação POST também retorna cabeçalhos de resposta, incluindo
Operation-Location
que fornece um valor usado em solicitações GET subsequentes.
Configurar o ambiente do Java
Neste início rápido, usamos a ferramenta de automação de build do Gradle para criar e executar o aplicativo.
Você deve ter a última versão do Visual Studio Code ou do seu IDE preferido. ConsulteJava no Visual Studio Code.
Dica
- Visual Studio Code oferece um Pacote de Codificação para Java para Windows e macOS. O pacote de codificação é um pacote de VS Code, o JDK (Java Development Kit) e uma coleção de extensões sugeridas pela Microsoft. O Pacote de Codificação também pode ser usado para corrigir um ambiente de desenvolvimento existente.
- Se você estiver usando VS Code e o Pacote de Codificação para Java, instale a extensão Gradle para Java.
Se não estiver usando Visual Studio Code, você deverá ter o seguinte instalado em seu ambiente de desenvolvimento:
Um Java Development Kit (OpenJDK) versão 8 ou posterior.
Gradle, versão 6.8 ou posterior.
Criar um novo projeto Gradle
Na janela de console (como o cmd, o PowerShell ou o Bash), crie um diretório chamado document-translation para seu aplicativo e navegue até ele.
mkdir document-translation && document-translation
mkdir document-translation; cd document-translation
Execute o comando
gradle init
no diretório document-translation. Esse comando cria arquivos de build essenciais para o Gradle, incluindo o build.gradle.kts, que é usado no runtime para criar e configurar seu aplicativo.gradle init --type basic
Quando solicitado a escolher uma DSL, escolha Kotlin.
Aceite o nome do projeto padrão (document-translation) selecionando RETORNAR ou ENTER.
Observação
Pode levar alguns minutos para que todo o aplicativo seja criado, mas em breve serão exibidas várias pastas e arquivos, incluindo
build-gradle.kts
.Atualize
build.gradle.kts
com o seguinte código:
plugins {
java
application
}
application {
mainClass.set("DocumentTranslation")
}
repositories {
mavenCentral()
}
dependencies {
implementation("com.squareup.okhttp3:okhttp:4.10.0")
implementation("com.google.code.gson:gson:2.9.0")
}
Traduzir todos os documentos em um contêiner de armazenamento
Do diretório document-translation, execute o comando a seguir:
mkdir -p src/main/java
O comando cria a seguinte estrutura de diretório:
Navegue até o diretório do
java
e crie um arquivo chamadoDocumentTranslation.java
.Dica
Você pode criar um arquivo usando o PowerShell.
Abra uma janela do PowerShell no diretório do projeto mantendo a tecla Shift e clicando com o botão direito do mouse na pasta.
Insira o seguinte comando New-Item DocumentTranslation.java.
Crie também um arquivo no IDE chamado
DocumentTranslation.java
e salve-o no diretóriojava
.
Copiar e colar o código de exemplo da tradução de documento no arquivo DocumentTranslation.java.
Atualizar
{your-document-translation-endpoint}
e{your-key}
com valores de sua instância de Tradução do portal do Azure.Atualizar
{your-source-container-SAS-URL}
e{your-target-container-SAS-URL}
com valores de sua instância de contêineres da conta de armazenamento do portal do Azure.
Exemplo de código
Importante
Lembre-se de remover a chave do seu código quando terminar e nunca poste-a publicamente. Para produção, use uma maneira segura de armazenar e acessar suas credenciais, como o Azure Key Vault. Para obter mais informações, consulte a segurança dos serviços de IA do Azure.
import java.io.*;
import java.net.*;
import java.util.*;
import okhttp3.*;
public class DocumentTranslation {
String key = "{your-key}";
String endpoint = "{your-document-translation-endpoint}/translator/text/batch/v1.1";
String path = endpoint + "/batches";
String sourceSASUrl = "{your-source-container-SAS-URL}";
String targetSASUrl = "{your-target-container-SAS-URL}";
String jsonInputString = (String.format("{\"inputs\":[{\"source\":{\"sourceUrl\":\"%s\"},\"targets\":[{\"targetUrl\":\"%s\",\"language\":\"fr\"}]}]}", sourceSASUrl, targetSASUrl));
OkHttpClient client = new OkHttpClient();
public void post() throws IOException {
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, jsonInputString);
Request request = new Request.Builder()
.url(path).post(body)
.addHeader("Ocp-Apim-Subscription-Key", key)
.addHeader("Content-type", "application/json")
.build();
Response response = client.newCall(request).execute();
System.out.println(response.code());
System.out.println(response.headers());
}
public static void main(String[] args) {
try {
DocumentTranslation sampleRequest = new DocumentTranslation();
sampleRequest.post();
} catch (Exception e) {
System.out.println(e);
}
}
}
Compilar e executar seu aplicativo do Java
Depois de adicionar um exemplo de código ao aplicativo, volte ao diretório principal do projeto, document-translation, abra uma janela do console e insira os seguintes comandos:
Crie seu aplicativo com o comando
build
:gradle build
Execute seu aplicativo com o comando
run
:gradle run
Após a conclusão bem-sucedida:
- Os documentos traduzidos podem ser encontrados no seu contêiner de destino.
- O método POST bem-sucedido retorna um código de resposta
202 Accepted
indicando que o serviço criou a solicitação em lote. - A solicitação POST também retorna cabeçalhos de resposta, incluindo
Operation-Location
que fornece um valor usado em solicitações GET subsequentes.
Configurar o ambiente Node.js
Neste início rápido, usamos o ambiente de runtime do JavaScript do Node.js para criar e executar o aplicativo.
Caso ainda não tenha feito isso, instale a última versão do Node.js. O npm (Node Package Manager) está incluído na instalação do Node.js.
Dica
Caso não esteja familiarizado com o Node.js, experimente o módulo Introdução ao Node.js do Learn.
Em uma janela de console (como o cmd, o PowerShell ou o Bash), crie um diretório chamado
document-translation
para seu aplicativo e navegue até ele.mkdir document-translation && cd document-translation
mkdir document-translation; cd document-translation
Execute o comando npm init para inicializar o aplicativo e fazer scaffold do projeto.
npm init
Especifique os atributos do projeto aceitando os prompts apresentados no terminal.
- Os atributos mais importantes são nome, número de versão e ponto de entrada.
- É recomendável manter
index.js
para o nome do ponto de entrada. Descrição, comando de teste, repositório GitHub, palavras-chave, autor e informações de licença são atributos opcionais - eles podem ser ignorados para este projeto. - Aceite as sugestões entre parênteses selecionando Retornar ou Enter.
- Depois que você concluir os prompts, um arquivo
package.json
será criado no diretório document-translation.
Use o npm para instalar a biblioteca HTTP
axios
e o pacoteuuid
no diretório do aplicativo document-translation:npm install axios uuid
Traduzir todos os documentos em um contêiner de armazenamento
Crie o arquivo
index.js
no diretório do aplicativo.Dica
Você pode criar um arquivo usando o PowerShell.
Abra uma janela do PowerShell no diretório do projeto mantendo a tecla Shift e clicando com o botão direito do mouse na pasta.
Digite o seguinte comando: New-Item index.js.
Crie também um arquivo chamado
index.js
no IDE e salve-o no diretóriodocument-translation
.
Copiar e colar o código de exemplo da tradução de documento no arquivo
index.js
.Atualizar
{your-document-translation-endpoint}
e{your-key}
com valores de sua instância de Tradução do portal do Azure.Atualizar
{your-source-container-SAS-URL}
e{your-target-container-SAS-URL}
com valores de sua instância de contêineres da conta de armazenamento do portal do Azure.
Exemplo de código
Importante
Lembre-se de remover a chave do seu código quando terminar e nunca poste-a publicamente. Para produção, use uma maneira segura de armazenar e acessar suas credenciais, como o Azure Key Vault. Para obter mais informações, consulte a segurança dos serviços de IA do Azure.
const axios = require('axios').default;
let endpoint = '{your-document-translation-endpoint}/translator/text/batch/v1.1';
let route = '/batches';
let key = '{your-key}';
let sourceSASUrl = "{your-source-container-SAS-URL}";
let targetSASUrl = "{your-target-container-SAS-URL}"
let data = JSON.stringify({"inputs": [
{
"source": {
"sourceUrl": sourceSASUrl,
"storageSource": "AzureBlob",
"language": "en"
},
"targets": [
{
"targetUrl": targetSASUrl,
"storageSource": "AzureBlob",
"category": "general",
"language": "es"}]}]});
let config = {
method: 'post',
baseURL: endpoint,
url: route,
headers: {
'Ocp-Apim-Subscription-Key': key,
'Content-Type': 'application/json'
},
data: data
};
axios(config)
.then(function (response) {
let result = { statusText: response.statusText, statusCode: response.status, headers: response.headers };
console.log()
console.log(JSON.stringify(result, null, 2));
})
.catch(function (error) {
console.log(error);
});
Executar seu aplicativo JavaScript
Depois de adicionar um exemplo de código ao aplicativo, execute o programa:
Procure o diretório do aplicativo (document-translation).
Insira e execute o comando a seguir no seu terminal:
node index.js
Após a conclusão bem-sucedida:
- Os documentos traduzidos podem ser encontrados no seu contêiner de destino.
- O método POST bem-sucedido retorna um código de resposta
202 Accepted
indicando que o serviço criou a solicitação em lote. - A solicitação POST também retorna cabeçalhos de resposta, incluindo
Operation-Location
que fornece um valor usado em solicitações GET subsequentes.
Configurar seu projeto Python
Caso ainda não tenha feito isso, instale a última versão do Python 3.x. O pip (pacote do instalador do Python) está incluído na instalação do Python.
Dica
Caso não esteja familiarizado com o Python, experimente o módulo Introdução ao Python do Learn.
Abra uma janela do terminal e use o pip para instalar a biblioteca Requests e o pacote uuid0:
pip install requests uuid
Traduzir todos os documentos em um contêiner de armazenamento
Usando seu editor ou IDE favorito, crie um novo diretório para seu aplicativo chamado
document-translation
.Crie um novo arquivo Python chamado document-translation.py no diretório document-translation.
Copiar e colar o código de exemplo da tradução de documento no arquivo
document-translation.py
.Atualizar
{your-document-translation-endpoint}
e{your-key}
com valores de sua instância de Tradução do portal do Azure.Atualizar
{your-source-container-SAS-URL}
e{your-target-container-SAS-URL}
com valores de sua instância de contêineres da conta de armazenamento do portal do Azure.
Exemplo de código
Importante
Lembre-se de remover a chave do seu código quando terminar e nunca poste-a publicamente. Para produção, use uma maneira segura de armazenar e acessar suas credenciais, como o Azure Key Vault. Para obter mais informações, consulte a segurança dos serviços de IA do Azure.
import requests
endpoint = '{your-document-translation-endpoint}'
key = '{your-key}'
path = 'translator/text/batch/v1.1/batches'
constructed_url = endpoint + path
sourceSASUrl = '{your-source-container-SAS-URL}'
targetSASUrl = '{your-target-container-SAS-URL}'
body= {
"inputs": [
{
"source": {
"sourceUrl": sourceSASUrl,
"storageSource": "AzureBlob",
"language": "en"
},
"targets": [
{
"targetUrl": targetSASUrl,
"storageSource": "AzureBlob",
"category": "general",
"language": "es"
}
]
}
]
}
headers = {
'Ocp-Apim-Subscription-Key': key,
'Content-Type': 'application/json',
}
response = requests.post(constructed_url, headers=headers, json=body)
response_headers = response.headers
print(f'response status code: {response.status_code}\nresponse status: {response.reason}\n\nresponse headers:\n')
for key, value in response_headers.items():
print(key, ":", value)
Executar seu aplicativo Python
Depois de adicionar um código de exemplo ao aplicativo, compile e execute o programa:
Navegue até o diretório document-translation.
Insira e execute o comando a seguir no console:
python document-translation.py
Após a conclusão bem-sucedida:
- Os documentos traduzidos podem ser encontrados no seu contêiner de destino.
- O método POST bem-sucedido retorna um código de resposta
202 Accepted
indicando que o serviço criou a solicitação em lote. - A solicitação POST também retorna cabeçalhos de resposta, incluindo
Operation-Location
que fornece um valor usado em solicitações GET subsequentes.
Configure seu ambiente de programação
Neste início rápido, usamos a ferramenta de linha de comando cURL para fazer chamadas à API REST de Tradução de Documentos.
Observação
O pacote cURL é pré-instalado na maioria dos Windows 10 e Windows 11 e na maioria das distribuições macOS e Linux. Você pode verificar a versão do pacote com os seguintes comandos: Windows: curl.exe -V
.
macOS curl -V
Linux: curl --version
Se o cURL não estiver instalado, aqui estão os links para sua plataforma:
Traduzir documentos (solicitação POST)
Usando seu editor ou IDE favorito, crie um novo diretório para seu aplicativo chamado
document-translation
.Crie um novo arquivo JSON chamado document-translation.json no diretório document-translation.
Copiar e colar a solicitação de exemplo da tradução de documento no arquivo
document-translation.json
. Substituir{your-source-container-SAS-URL}
e{your-target-container-SAS-URL}
pelos valores de sua instância de contêineres da conta de armazenamento do portal do Azure.**Request sample**
{ "inputs":[ { "source":{ "sourceUrl":"{your-source-container-SAS-URL}" }, "targets":[ { "targetUrl":"{your-target-container-SAS-URL}", "language":"fr" } ] } ] }
Compilar e executar a solicitação POST
Antes de executar a solicitação POST, substitua {your-document-translator-endpoint}
e {your-key}
pelos valores da instância do Tradutor do portal do Microsoft Azure.
Importante
Lembre-se de remover a chave do seu código quando terminar e nunca poste-a publicamente. Para produção, use uma maneira segura de armazenar e acessar suas credenciais, como o Azure Key Vault. Para obter mais informações, consulte a segurança dos serviços de IA do Azure.
PowerShell
cmd /c curl "{your-document-translator-endpoint}/translator/text/batch/v1.1/batches" -i -X POST --header "Content-Type: application/json" --header "Ocp-Apim-Subscription-Key: {your-key}" --data "@document-translation.json"
Terminal/prompt de comando
curl "{your-document-translator-endpoint}/translator/text/batch/v1.1/batches" -i -X POST --header "Content-Type: application/json" --header "Ocp-Apim-Subscription-Key: {your-key}" --data "@document-translation.json"
Após a conclusão bem-sucedida:
- Os documentos traduzidos podem ser encontrados no seu contêiner de destino.
- O método POST bem-sucedido retorna um código de resposta
202 Accepted
indicando que o serviço criou a solicitação em lote. - A solicitação POST também retorna cabeçalhos de resposta, incluindo
Operation-Location
que fornece um valor usado em solicitações GET subsequentes.
É isso, parabéns! Neste início rápido, você usou a Tradução de Documentos para traduzir um documento preservando sua estrutura original e o formato de dados.