Como Integrar uma API de Tradução de Documentos em Francês (Passo a Passo)

Criar URL de Upload Pré-assinada

Antes de fazer o upload do seu documento em francês, você deve solicitar uma URL segura e temporária. Isso garante que seus dados sejam tratados com segurança de nível empresarial. Para documentos digitalizados, lembre-se de definir o parâmetro de OCR.

Sucesso: Você recebe um file_id e uma upload_url exclusiva.

Enviar a Tarefa de Tradução

Assim que o arquivo for carregado, acione o motor de tradução. É aqui que você especifica que a origem é o francês. Integrar a melhor alternativa de API de tradução por IA ao DeepL permite um tratamento de contexto superior.

Erro Comum: Usar o código ISO errado. Sempre use "fr" para francês.

Exemplo de Implementação em Python

Automatize todo o fluxo de trabalho usando este script Python. Ele lida com a lógica de envio e consulta (polling) necessária para o desempenho da API de tradução de arquivos mais rápida.

import requests
import time

# Envia a tradução para um documento em francês
response = requests.post(
    f"{BASE_URL}/translate/document",
    json={
        "file_id": int(file_id),
        "source_language": "fr",
        "target_language": "en",
        "trans_mode": "master"
    },
    headers=headers
)

# Consulta o status até ser concluído
while True:
    status_resp = requests.post(
        f"{BASE_URL}/translate/status",
        json={"file_id": file_id},
        headers=headers
    )
    result = status_resp.json()["data"]
    if result["status_name"] == "completed":
        print(f"URL de Download: {result['download_url']}")
        break
    time.sleep(5)