Prueba a traducir documentos con formato

Los servicios de Vertex AI Translation y de reconocimiento óptico de caracteres (OCR) se combinan para ofrecer una función de procesamiento de documentos llamada Document Translate.

Document Translate traduce directamente documentos con formato, como archivos PDF. A diferencia de las traducciones de texto sin formato, esta función conserva el formato y el diseño originales de los documentos traducidos, lo que te ayuda a mantener gran parte del contexto original, como los saltos de párrafo.

Traducción de documentos admite traducciones de documentos en línea, desde segmentos de almacenamiento y por lotes.

Esta página te guiará por una experiencia interactiva en la que usarás la función de procesamiento de documentos de Google Distributed Cloud (GDC) aislado para traducir documentos conservando su formato.

Formatos admitidos

Traducción de documentos admite los siguientes tipos de archivos de entrada y sus tipos de archivos de salida asociados:

Entradas Tipo de MIME del documento Salida
PDF application/pdf PDF, DOCX
DOC application/msword DOC, DOCX
DOCX application/vnd.openxmlformats-officedocument.wordprocessingml.document DOCX
PPT application/vnd.ms-powerpoint PPT, PPTX
PPTX application/vnd.openxmlformats-officedocument.presentationml.presentation PPTX
XLS application/vnd.ms-excel XLS, XLSX
XLSX application/vnd.openxmlformats-officedocument.spreadsheetml.sheet XLSX

Traducciones de documentos PDF originales y escaneados

Traducción de documentos admite archivos PDF originales y escaneados, incluidas las traducciones de idiomas que se escriben de derecha a izquierda o viceversa. Además, Traducción de documentos conserva los hiperenlaces, el tamaño de fuente y el color de fuente de los archivos.

Antes de empezar

Para poder empezar a usar la función de procesamiento de documentos, debes tener un proyecto llamado dt-project. El recurso personalizado del proyecto debe ser similar al del siguiente ejemplo:

apiVersion: resourcemanager.gdc.goog/v1
kind: Project
metadata:
  labels:
    atat.config.google.com/clin-number: CLIN_NUMBER
    atat.config.google.com/task-order-number: TASK_ORDER_NUMBER
  name: dt-project
  namespace: platform

Además, debes habilitar las APIs preentrenadas de Vertex AI Translation y OCR, y tener las credenciales adecuadas. Te recomendamos que instales las bibliotecas de cliente de Vertex AI Translation y OCR para facilitar las llamadas a la API. Para obtener más información sobre los requisitos, consulta Configurar un proyecto de traducción.

Traducir un documento de un segmento de almacenamiento

Para traducir un documento almacenado en un segmento, usa la API Vertex AI Translation.

En esta sección se describe cómo traducir un documento de un segmento y almacenar el resultado en otra ruta de segmento de salida. La respuesta también devuelve un flujo de bytes. Puedes especificar el tipo de MIME. Si no lo haces, Traducción de documentos lo determinará usando la extensión del archivo de entrada.

Document Translate admite la detección automática de idiomas en los documentos almacenados en segmentos. Si no especificas un código de idioma de origen, Traducción de documentos lo detectará automáticamente. El idioma detectado se incluye en la salida en el campo detectedLanguageCode.

Sigue estos pasos para traducir un documento de un segmento de almacenamiento:

  1. Configura la CLI gdcloud para el almacenamiento de objetos.
  2. Crea un segmento de almacenamiento en el espacio de nombres de dt-project. Usa una clase de almacenamiento Standard.

    Puedes crear el segmento de almacenamiento desplegando un recurso Bucket en el espacio de nombres dt-project:

      apiVersion: object.gdc.goog/v1
      kind: Bucket
      metadata:
        name: dt-bucket
        namespace: dt-project
      spec:
        description: bucket for document vision service
        storageClass: Standard
        bucketPolicy:
          lockingPolicy:
            defaultObjectRetentionDays: 90
    
  3. Concede los permisos read y write en el segmento a las cuentas de servicio (ai-translation-system-sa y g-vai-translation-sie-sa) que usa el servicio Vertex AI Translation.

    Sigue estos pasos para crear el rol y la vinculación de roles usando recursos personalizados en el servidor de la API de gestión:

    1. Crea el rol desplegando un recurso Role en el espacio de nombres dt-project:

        apiVersion: rbac.authorization.k8s.io/v1
        kind: Role
        metadata:
          name: dvs-reader-writer
          namespace: dt-project
        rules:
          -
            apiGroups:
              - object.gdc.goog
            resources:
              - buckets
            verbs:
              - read-object
              - write-object
      
    2. Crea la vinculación de roles desplegando un recurso RoleBinding en el espacio de nombres dt-project:

        apiVersion: rbac.authorization.k8s.io/v1
        kind: RoleBinding
        metadata:
          name: dvs-reader-writer-rolebinding
          namespace: dt-project
        roleRef:
          apiGroup: rbac.authorization.k8s.io
          kind: Role
          name: dvs-reader-writer
        subjects:
          -
            kind: ServiceAccount
            name: ai-translation-system-sa
            namespace: g-vai-translation-sie
          -
            kind: ServiceAccount
            name: g-vai-translation-sie-sa
            namespace: g-vai-translation-sie
      
  4. Sube el documento al segmento de almacenamiento que has creado. Para obtener más información, consulta el artículo Subir y descargar objetos de almacenamiento en proyectos.

  5. Haz una solicitud a la API preentrenada de Vertex AI Translation:

    curl

    Sigue estos pasos para hacer una solicitud de curl:

    1. Guarda el siguiente archivo request.json:

      cat <<- EOF > request.json
      {
        "parent": "projects/PROJECT_ID/locations/PROJECT_ID",
        "source_language_code": "SOURCE_LANGUAGE",
        "target_language_code": "TARGET_LANGUAGE",
        "document_input_config": {
          "mime_type": "application/pdf",
          "s3_source": {
            "input_uri": "s3://INPUT_FILE_PATH"
          }
        },
        "document_output_config": {
          "mime_type": "application/pdf"
        },
        "enable_rotation_correction": "true"
      }
      EOF
      

      Haz los cambios siguientes:

      • PROJECT_ID: el ID de tu proyecto.
      • SOURCE_LANGUAGE: el idioma en el que está escrito el documento. Consulta la lista de idiomas admitidos y sus códigos correspondientes.
      • TARGET_LANGUAGE: el idioma o los idiomas a los que quieres traducir el documento. Consulta la lista de idiomas admitidos y sus códigos correspondientes.
      • INPUT_FILE_PATH: la ruta del archivo de documento en el segmento de almacenamiento.

      Modifica el valor mime_type según tu documento.

    2. Obtén un token de autenticación.

    3. Haz la solicitud:

      curl -vv --data-binary @- -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT:443/v3/projects/PROJECT_ID/locations/PROJECT_ID:translateDocument < request.json
      

      Haz los cambios siguientes:

Traducir un documento de forma integrada

En esta sección se describe cómo enviar un documento insertado como parte de la solicitud a la API. Debes incluir el tipo de MIME para las traducciones de documentos insertados.

Traducción de documentos admite la detección automática de idiomas para las traducciones de texto insertado. Si no especificas un código de idioma de origen, Traducción de documentos lo detectará automáticamente. El idioma detectado se incluye en la salida en el campo detectedLanguageCode.

Haz una solicitud a la API preentrenada de Vertex AI Translation:

curl

Sigue estos pasos para hacer una solicitud de curl:

  1. Obtén un token de autenticación.

  2. Haz la solicitud:

echo '{"parent": "projects/PROJECT_ID/locations/PROJECT_ID","source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "document_input_config": { "mime_type": "application/pdf", "content": "'$(base64 -w 0 INPUT_FILE_PATH)'" }, "document_output_config": { "mime_type": "application/pdf" }, "enable_rotation_correction": "true"}' | curl --data-binary @- -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID/locations/PROJECT_ID:translateDocument

Haz los cambios siguientes:

  • PROJECT_ID: el ID de tu proyecto.
  • SOURCE_LANGUAGE: el idioma en el que está escrito el documento. Consulta la lista de idiomas admitidos y sus códigos correspondientes.
  • TARGET_LANGUAGE: el idioma o los idiomas a los que quieres traducir el documento. Consulta la lista de idiomas admitidos y sus códigos correspondientes.
  • INPUT_FILE_PATH: la ruta del archivo de documento de forma local.
  • TOKEN: el token de autenticación que has obtenido.
  • ENDPOINT: el endpoint de Vertex AI Translation que usas en tu organización. Para obtener más información, consulta el estado del servicio y los puntos finales.

Traducir documentos por lotes

La traducción por lotes te permite traducir varios archivos a varios idiomas en una sola solicitud. En cada solicitud, puedes enviar hasta 100 archivos con un tamaño de contenido total de hasta 1 GB o 100 millones de puntos de código Unicode, lo que se alcance primero. Puedes especificar un modelo de traducción concreto para cada idioma.

Para obtener más información, consulta batchTranslateDocument.

Traducir varios documentos

El siguiente ejemplo incluye varias configuraciones de entrada. Cada configuración de entrada es un puntero a un archivo de un segmento de almacenamiento.

Haz una solicitud a la API preentrenada de Vertex AI Translation:

curl

Sigue estos pasos para hacer una solicitud de curl:

  1. Guarda el siguiente cuerpo de solicitud en un archivo llamado request.json:

    {
      "source_language_code": "SOURCE_LANGUAGE",
      "target_language_codes": ["TARGET_LANGUAGE"],
      "input_configs": [
        {
          "s3_source": {
            "input_uri": "s3://INPUT_FILE_PATH_1"
          }
        },
        {
          "s3_source": {
            "input_uri": "s3://INPUT_FILE_PATH_2"
          }
        }
      ],
      "output_config": {
        "s3_destination": {
          "output_uri_prefix": "s3://OUTPUT_FILE_PREFIX"
        }
      }
    }
    

    Haz los cambios siguientes:

    • SOURCE_LANGUAGE: el código de idioma de los documentos de entrada. Consulta la lista de idiomas admitidos y sus códigos correspondientes.
    • TARGET_LANGUAGE: el idioma o los idiomas de destino a los que se traducirán los documentos de entrada. Consulta la lista de idiomas admitidos y sus códigos correspondientes.
    • INPUT_FILE_PATH_1 y INPUT_FILE_PATH_2: las ubicaciones de los segmentos de almacenamiento y los nombres de archivo de los documentos de entrada.
    • OUTPUT_FILE_PREFIX: la ubicación del segmento de almacenamiento donde se guardan todos los documentos de salida.
  2. Obtén un token de autenticación.

  3. Haz la solicitud:

    curl -X POST \
      -H "Authorization: Bearer TOKEN" \
      -H "Content-Type: application/json; charset=utf-8" \
      -d @request.json \
      "https://ENDPOINT:443/v3/projects/PROJECT_ID/locations/PROJECT_ID:batchTranslateDocument"
    

    Haz los cambios siguientes:

La respuesta contiene el ID de una operación de larga duración:

{
"name": "projects/PROJECT_ID/operations/OPERATION_ID",
"metadata": {
  "@type": "type.googleapis.com/google.cloud.translation.v3.BatchTranslateDocumentMetadata",
  "state": "RUNNING"
}
}

Traducir y convertir un archivo PDF original

En el siguiente ejemplo, se traduce y se convierte un archivo PDF original en un archivo DOCX. Puedes especificar varias entradas de varios tipos de archivo. No es necesario que todas sean archivos PDF originales. Sin embargo, no se pueden incluir archivos PDF escaneados al incluir una conversión; la solicitud se rechaza y no se realizan traducciones. Solo se traducen y se convierten a archivos DOCX los archivos PDF originales. Por ejemplo, si incluyes archivos PPTX, se traducirán y se devolverán como archivos PPTX.

Si sueles traducir una combinación de archivos PDF escaneados y originales, te recomendamos que los organices en grupos independientes. De esta forma, cuando solicites una traducción y conversión por lotes, podrás excluir el segmento que contiene los archivos PDF escaneados en lugar de tener que excluir archivos concretos.

Haz una solicitud a la API preentrenada de Vertex AI Translation:

curl

Sigue estos pasos para hacer una solicitud de curl:

  1. Guarda el siguiente cuerpo de solicitud en un archivo llamado request.json:

    {
      "source_language_code": "SOURCE_LANGUAGE",
      "target_language_codes": ["TARGET_LANGUAGE"],
      "input_configs": [
        {
          "s3_source": {
            "input_uri": "s3://INPUT_FILE_PATH_1"
          }
        },
        {
          "s3_source": {
            "input_uri": "s3://INPUT_FILE_PATH_2"
          }
        }
      ],
      "output_config": {
        "s3_destination": {
          "output_uri_prefix": "s3://OUTPUT_FILE_PREFIX"
        }
      },
      "format_conversions": {
        "application/pdf": "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
      }
    }
    

    Haz los cambios siguientes:

    • SOURCE_LANGUAGE: el código de idioma de los documentos de entrada. Consulta la lista de idiomas admitidos y sus códigos correspondientes.
    • TARGET_LANGUAGE: el idioma o los idiomas de destino a los que se traducirán los documentos de entrada. Consulta la lista de idiomas admitidos y sus códigos correspondientes.
    • INPUT_FILE_PATH_1 y INPUT_FILE_PATH_2: las ubicaciones de los segmentos de almacenamiento y los nombres de archivo de los documentos de entrada.
    • OUTPUT_FILE_PREFIX: la ubicación del segmento de almacenamiento donde se guardan todos los documentos de salida.
  2. Obtén un token de autenticación.

  3. Haz la solicitud:

    curl -X POST \
      -H "Authorization: Bearer TOKEN" \
      -H "Content-Type: application/json; charset=utf-8" \
      -d @request.json \
      "https://ENDPOINT:443/v3/projects/PROJECT_ID/locations/PROJECT_ID:batchTranslateDocument"
    

    Haz los cambios siguientes:

La respuesta contiene el ID de una operación de larga duración:

{
"name": "projects/PROJECT_ID/operations/OPERATION_ID",
"metadata": {
  "@type": "type.googleapis.com/google.cloud.translation.v3.BatchTranslateDocumentMetadata",
  "state": "RUNNING"
}
}

Usar un glosario

Puedes incluir un glosario para gestionar la terminología específica de un dominio. Si especificas un glosario, debes especificar el idioma de origen. En el siguiente ejemplo se usa un glosario. Puedes especificar hasta 10 idiomas de destino con su propio glosario.

Si especificas un glosario para algunos idiomas de destino, el sistema no usará ningún glosario para los idiomas no especificados.

Haz una solicitud a la API preentrenada de Vertex AI Translation:

curl

Sigue estos pasos para hacer una solicitud de curl:

  1. Guarda el siguiente cuerpo de solicitud en un archivo llamado request.json:

    {
      "source_language_code": "SOURCE_LANGUAGE",
      "target_language_codes": ["TARGET_LANGUAGE"],
      "input_configs": [
        {
          "s3_source": {
            "input_uri": "s3://INPUT_FILE_PATH"
          }
        }
      ],
      "output_config": {
        "s3_destination": {
          "output_uri_prefix": "s3://OUTPUT_FILE_PREFIX"
        }
      },
      "glossaries": {
        "TARGET_LANGUAGE": {
          "glossary": "projects/GLOSSARY_PROJECT_ID/glossaries/GLOSSARY_ID"
        }
      }
    }
    

    Haz los cambios siguientes:

    • SOURCE_LANGUAGE: el código de idioma de los documentos de entrada. Consulta la lista de idiomas admitidos y sus códigos correspondientes.
    • TARGET_LANGUAGE: el idioma o los idiomas de destino a los que se traducirán los documentos de entrada. Consulta la lista de idiomas admitidos y sus códigos correspondientes.
    • INPUT_FILE_PATH: la ubicación del segmento de almacenamiento y el nombre de archivo de uno o varios documentos de entrada.
    • OUTPUT_FILE_PREFIX: la ubicación del segmento de almacenamiento donde se guardan todos los documentos de salida.
    • GLOSSARY_PROJECT_ID: el ID del proyecto donde se encuentra el glosario.
    • GLOSSARY_ID: el ID del glosario.
  2. Obtén un token de autenticación.

  3. Haz la solicitud:

    curl -X POST \
      -H "Authorization: Bearer TOKEN" \
      -H "Content-Type: application/json; charset=utf-8" \
      -d @request.json \
      "https://ENDPOINT:443/v3/projects/PROJECT_ID/locations/PROJECT_ID:batchTranslateDocument"
    

    Haz los cambios siguientes:

La respuesta contiene el ID de una operación de larga duración:

{
"name": "projects/PROJECT_ID/operations/OPERATION_ID",
"metadata": {
  "@type": "type.googleapis.com/google.cloud.translation.v3.BatchTranslateDocumentMetadata",
  "state": "RUNNING"
}
}