Cómo Integrar una API de Traducción de Documentos en Francés (Paso a Paso)

Crear URL de Carga Pre-firmada

Antes de subir su documento en francés, debe solicitar una URL segura y temporal. Esto garantiza que sus datos se manejen con seguridad de nivel empresarial. Para documentos escaneados, recuerde establecer el parámetro de OCR.

Éxito: Recibirá un file_id y una upload_url única.

Enviar la Tarea de Traducción

Una vez que el archivo se ha subido, active el motor de traducción. Aquí es donde especifica que el origen es francés. Integrar la mejor alternativa de API de traducción con IA a DeepL permite un manejo superior del contexto.

Error Común: Usar el código ISO incorrecto. Siempre use "fr" para francés.

Ejemplo de Implementación en Python

Automatice todo el flujo de trabajo utilizando este script de Python. Maneja la lógica de envío y sondeo necesaria para el rendimiento de la API de traducción de archivos más rápida.

import requests
import time

# Enviar traducción para un documento en 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
)

# Consultar estado hasta que se complete
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 descarga: {result['download_url']}")
        break
    time.sleep(5)