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 |
|---|---|---|
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:
- Configura la CLI gdcloud para el almacenamiento de objetos.
Crea un segmento de almacenamiento en el espacio de nombres de
dt-project. Usa una clase de almacenamientoStandard.Puedes crear el segmento de almacenamiento desplegando un recurso
Bucketen el espacio de nombresdt-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: 90Concede los permisos
readywriteen el segmento a las cuentas de servicio (ai-translation-system-sayg-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:
Crea el rol desplegando un recurso
Roleen el espacio de nombresdt-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-objectCrea la vinculación de roles desplegando un recurso
RoleBindingen el espacio de nombresdt-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
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.
Haz una solicitud a la API preentrenada de Vertex AI Translation:
curl
Sigue estos pasos para hacer una solicitud de
curl: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" } EOFHaz 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_typesegún tu documento.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.jsonHaz los cambios siguientes:
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.PROJECT_ID: el ID de tu proyecto.
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:
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:
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_1yINPUT_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.
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:
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.PROJECT_ID: el ID de tu proyecto.
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:
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_1yINPUT_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.
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:
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.PROJECT_ID: el ID de tu proyecto.
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:
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.
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:
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.PROJECT_ID: el ID de tu proyecto.
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"
}
}