def sample_translation(): # [START begin_translation] import os from azure.core.credentials import AzureKeyCredential from azure.ai.translation.document import DocumentTranslationClient endpoint = os.environ["AZURE_DOCUMENT_TRANSLATION_ENDPOINT"] key = os.environ["AZURE_DOCUMENT_TRANSLATION_KEY"] source_container_url = os.environ["AZURE_SOURCE_CONTAINER_URL"] target_container_url = os.environ["AZURE_TARGET_CONTAINER_URL"] client = DocumentTranslationClient(endpoint, AzureKeyCredential(key)) poller = client.begin_translation(source_container_url, target_container_url, "fr") result = poller.result() print("Status: {}".format(poller.status())) print("Created on: {}".format(poller.details.created_on)) print("Last updated on: {}".format(poller.details.last_updated_on)) print("Total number of translations on documents: {}".format(poller.details.documents_total_count)) print("\nOf total documents...") print("{} failed".format(poller.details.documents_failed_count)) print("{} succeeded".format(poller.details.documents_succeeded_count)) for document in result: print("Document ID: {}".format(document.id)) print("Document status: {}".format(document.status)) if document.status == "Succeeded": print("Source document location: {}".format(document.source_document_url)) print("Translated document location: {}".format(document.translated_document_url)) print("Translated to language: {}\n".format(document.translated_to)) else: print("Error Code: {}, Message: {}\n".format(document.error.code, document.error.message))
def sample_multiple_translation(): import os from azure.core.credentials import AzureKeyCredential from azure.ai.translation.document import (DocumentTranslationClient, DocumentTranslationInput, TranslationTarget) endpoint = os.environ["AZURE_DOCUMENT_TRANSLATION_ENDPOINT"] key = os.environ["AZURE_DOCUMENT_TRANSLATION_KEY"] source_container_url_1 = os.environ["AZURE_SOURCE_CONTAINER_URL_1"] source_container_url_2 = os.environ["AZURE_SOURCE_CONTAINER_URL_2"] target_container_url_fr = os.environ["AZURE_TARGET_CONTAINER_URL_FR"] target_container_url_ar = os.environ["AZURE_TARGET_CONTAINER_URL_AR"] target_container_url_es = os.environ["AZURE_TARGET_CONTAINER_URL_ES"] client = DocumentTranslationClient(endpoint, AzureKeyCredential(key)) poller = client.begin_translation(inputs=[ DocumentTranslationInput( source_url=source_container_url_1, targets=[ TranslationTarget(target_url=target_container_url_fr, language_code="fr"), TranslationTarget(target_url=target_container_url_ar, language_code="ar") ]), DocumentTranslationInput(source_url=source_container_url_2, targets=[ TranslationTarget( target_url=target_container_url_es, language_code="es") ]) ]) result = poller.result() print(f"Status: {poller.status()}") print(f"Created on: {poller.details.created_on}") print(f"Last updated on: {poller.details.last_updated_on}") print( f"Total number of translations on documents: {poller.details.documents_total_count}" ) print("\nOf total documents...") print(f"{poller.details.documents_failed_count} failed") print(f"{poller.details.documents_succeeded_count} succeeded") for document in result: print(f"Document ID: {document.id}") print(f"Document status: {document.status}") if document.status == "Succeeded": print(f"Source document location: {document.source_document_url}") print( f"Translated document location: {document.translated_document_url}" ) print(f"Translated to language: {document.translated_to}\n") else: print( f"Error Code: {document.error.code}, Message: {document.error.message}\n" )
def sample_translation_with_glossaries(): import os from azure.core.credentials import AzureKeyCredential from azure.ai.translation.document import (DocumentTranslationClient, DocumentTranslationInput, TranslationTarget, TranslationGlossary) endpoint = os.environ["AZURE_DOCUMENT_TRANSLATION_ENDPOINT"] key = os.environ["AZURE_DOCUMENT_TRANSLATION_KEY"] source_container_url = os.environ["AZURE_SOURCE_CONTAINER_URL"] target_container_url = os.environ["AZURE_TARGET_CONTAINER_URL"] glossary_url = os.environ["AZURE_TRANSLATION_GLOSSARY_URL"] client = DocumentTranslationClient(endpoint, AzureKeyCredential(key)) inputs = DocumentTranslationInput( source_url=source_container_url, targets=[ TranslationTarget(target_url=target_container_url, language_code="es", glossaries=[ TranslationGlossary( glossary_url=glossary_url, file_format="TSV") ]) ]) poller = client.begin_translation(inputs=[inputs]) result = poller.result() print("Status: {}".format(poller.status())) print("Created on: {}".format(poller.details.created_on)) print("Last updated on: {}".format(poller.details.last_updated_on)) print("Total number of translations on documents: {}".format( poller.details.documents_total_count)) print("\nOf total documents...") print("{} failed".format(poller.details.documents_failed_count)) print("{} succeeded".format(poller.details.documents_succeeded_count)) for document in result: print("Document ID: {}".format(document.id)) print("Document status: {}".format(document.status)) if document.status == "Succeeded": print("Source document location: {}".format( document.source_document_url)) print("Translated document location: {}".format( document.translated_document_url)) print("Translated to language: {}\n".format( document.translated_to)) else: print("Error Code: {}, Message: {}\n".format( document.error.code, document.error.message))
def sample_document_status_checks(): # [START list_document_statuses] import os import time from azure.core.credentials import AzureKeyCredential from azure.ai.translation.document import DocumentTranslationClient endpoint = os.environ["AZURE_DOCUMENT_TRANSLATION_ENDPOINT"] key = os.environ["AZURE_DOCUMENT_TRANSLATION_KEY"] source_container_url = os.environ["AZURE_SOURCE_CONTAINER_URL"] target_container_url = os.environ["AZURE_TARGET_CONTAINER_URL"] client = DocumentTranslationClient(endpoint, AzureKeyCredential(key)) poller = client.begin_translation(source_container_url, target_container_url, "es") completed_docs = [] while not poller.done(): time.sleep(30) doc_statuses = client.list_document_statuses(poller.id) for document in doc_statuses: if document.id not in completed_docs: if document.status == "Succeeded": print( "Document at {} was translated to {} language. You can find translated document at {}" .format(document.source_document_url, document.translated_to, document.translated_document_url)) completed_docs.append(document.id) if document.status == "Failed": print( "Document at {} failed translation. Error Code: {}, Message: {}" .format(document.source_document_url, document.error.code, document.error.message)) completed_docs.append(document.id) if document.status == "Running": print( "Document ID: {}, translation progress is {} percent". format(document.id, document.translation_progress * 100)) print("\nTranslation completed.")
def sample_translation_with_custom_model(): import os from azure.core.credentials import AzureKeyCredential from azure.ai.translation.document import (DocumentTranslationClient) endpoint = os.environ["AZURE_DOCUMENT_TRANSLATION_ENDPOINT"] key = os.environ["AZURE_DOCUMENT_TRANSLATION_KEY"] source_container_url = os.environ["AZURE_SOURCE_CONTAINER_URL"] target_container_url = os.environ["AZURE_TARGET_CONTAINER_URL"] custom_model_id = os.environ["AZURE_CUSTOM_MODEL_ID"] client = DocumentTranslationClient(endpoint, AzureKeyCredential(key)) poller = client.begin_translation(source_container_url, target_container_url, "es", category_id=custom_model_id) result = poller.result() print(f"Operation status: {poller.details.status}") print(f"Operation created on: {poller.details.created_on}") print(f"Operation last updated on: {poller.details.last_updated_on}") print( f"Total number of translations on documents: {poller.details.documents_total_count}" ) print("\nOf total documents...") print(f"{poller.details.documents_failed_count} failed") print(f"{poller.details.documents_succeeded_count} succeeded") for document in result: print(f"Document ID: {document.id}") print(f"Document status: {document.status}") if document.status == "Succeeded": print(f"Source document location: {document.source_document_url}") print( f"Translated document location: {document.translated_document_url}" ) print(f"Translated to language: {document.translated_to}\n") else: print( f"Error Code: {document.error.code}, Message: {document.error.message}\n" )
def sample_translation_specific_document(): import os from azure.core.credentials import AzureKeyCredential from azure.ai.translation.document import DocumentTranslationClient endpoint = os.environ["AZURE_DOCUMENT_TRANSLATION_ENDPOINT"] key = os.environ["AZURE_DOCUMENT_TRANSLATION_KEY"] source_blob_url = os.environ["AZURE_SOURCE_BLOB_URL"] target_blob_url = os.environ["AZURE_TARGET_BLOB_URL"] client = DocumentTranslationClient(endpoint, AzureKeyCredential(key)) poller = client.begin_translation(source_blob_url, target_blob_url, "fr", storage_type="File") result = poller.result() for document in result: print(f"Document ID: {document.id}") print(f"Document status: {document.status}") if document.status == "Succeeded": print(f"Source document location: {document.source_document_url}") print(f"Translated document location: {document.translated_document_url}") print(f"Translated to language: {document.translated_to}\n") else: print(f"Error Code: {document.error.code}, Message: {document.error.message}\n")
def sample_translation_under_folder(): import os from azure.core.credentials import AzureKeyCredential from azure.ai.translation.document import DocumentTranslationClient endpoint = os.environ["AZURE_DOCUMENT_TRANSLATION_ENDPOINT"] key = os.environ["AZURE_DOCUMENT_TRANSLATION_KEY"] source_container_url = os.environ["AZURE_SOURCE_CONTAINER_URL"] # do not include the folder name in source url target_container_url = os.environ["AZURE_TARGET_CONTAINER_URL"] client = DocumentTranslationClient(endpoint, AzureKeyCredential(key)) poller = client.begin_translation(source_container_url, target_container_url, "fr", prefix="myfoldername") result = poller.result() for document in result: print(f"Document ID: {document.id}") print(f"Document status: {document.status}") if document.status == "Succeeded": print(f"Source document location: {document.source_document_url}") print(f"Translated document location: {document.translated_document_url}") print(f"Translated to language: {document.translated_to}\n") else: print(f"Error Code: {document.error.code}, Message: {document.error.message}\n")
def sample_translation_with_azure_blob(self): translation_client = DocumentTranslationClient( self.endpoint, AzureKeyCredential(self.key)) blob_service_client = BlobServiceClient(self.storage_endpoint, credential=self.storage_key) source_container = self.create_container( blob_service_client, container_name=self.storage_source_container_name or "translation-source-container", ) target_container = self.create_container( blob_service_client, container_name=self.storage_target_container_name or "translation-target-container") if self.document_name: with open(self.document_name, "rb") as doc: source_container.upload_blob(self.document_name, doc) else: self.document_name = "example_document.txt" source_container.upload_blob( name=self.document_name, data= b"This is an example translation with the document translation client library" ) print( f"Uploaded document {self.document_name} to storage container {source_container.container_name}" ) source_container_sas_url = self.generate_sas_url(source_container, permissions="rl") target_container_sas_url = self.generate_sas_url(target_container, permissions="wl") poller = translation_client.begin_translation( source_container_sas_url, target_container_sas_url, "fr") print(f"Created translation operation with ID: {poller.id}") print("Waiting until translation completes...") result = poller.result() print(f"Status: {poller.status()}") print("\nDocument results:") for document in result: print(f"Document ID: {document.id}") print(f"Document status: {document.status}") if document.status == "Succeeded": print( f"Source document location: {document.source_document_url}" ) print( f"Translated document location: {document.translated_document_url}" ) print(f"Translated to language: {document.translated_to}\n") blob_client = BlobClient.from_blob_url( document.translated_document_url, credential=self.storage_key) with open("translated_" + self.document_name, "wb") as my_blob: download_stream = blob_client.download_blob() my_blob.write(download_stream.readall()) print("Downloaded {} locally".format("translated_" + self.document_name)) else: print("\nThere was a problem translating your document.") print( f"Document Error Code: {document.error.code}, Message: {document.error.message}\n" )