# Amazon Translate Developer Guide

> Translate text with Amazon Translate.

- [What is Amazon Translate?](https://docs.aws.amazon.com/translate/latest/dg/what-is.md)
- [Supported languages](https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.md)
- [How it works](https://docs.aws.amazon.com/translate/latest/dg/how-it-works.md)
- [Guidelines and quotas](https://docs.aws.amazon.com/translate/latest/dg/what-is-limits.md)
- [Document history](https://docs.aws.amazon.com/translate/latest/dg/doc-history.md)
- [API reference](https://docs.aws.amazon.com/translate/latest/dg/api_reference.md)
- [AWS Glossary](https://docs.aws.amazon.com/translate/latest/dg/glossary.md)

## [Setting up](https://docs.aws.amazon.com/translate/latest/dg/setting-up.md)

- [Working with AWS SDKs](https://docs.aws.amazon.com/translate/latest/dg/sdk-general-information-section.md): Provides links to AWS SDK developer guides and to code example folders (on GitHub) to help interested customers quickly find the information they need to start building applications.


## [Getting started](https://docs.aws.amazon.com/translate/latest/dg/getting-started.md)

- [Getting started (console)](https://docs.aws.amazon.com/translate/latest/dg/get-started-console.md): The easiest way to get started with Amazon Translate is to use the console to translate some text.
- [Getting started (AWS CLI)](https://docs.aws.amazon.com/translate/latest/dg/get-started-cli.md): In the following exercise, you use the AWS command line interface (AWS CLI) to translate text.
- [Getting started (SDK)](https://docs.aws.amazon.com/translate/latest/dg/get-started-sdk.md): AWS provides SDKs for various computer languages.


## [Translation processing modes](https://docs.aws.amazon.com/translate/latest/dg/processing.md)

### [Real-time translation](https://docs.aws.amazon.com/translate/latest/dg/sync.md)

Amazon Translate provides real-time document and text translation operations that immediately return the translations.

- [Real-time translation (console)](https://docs.aws.amazon.com/translate/latest/dg/sync-console.md): To use the console for real-time translations, paste input text into the Source language text box or provide the input text as a file.
- [Real-time translation (API)](https://docs.aws.amazon.com/translate/latest/dg/sync-api.md): Amazon Translate provides the following real-time translation operations to support interactive applications:

### [Asynchronous batch processing](https://docs.aws.amazon.com/translate/latest/dg/async.md)

To translate large collections of documents (up to 5 GB in size), use the Amazon Translate asynchronous batch processing operation, StartTextTranslationJob.

- [Prerequisites](https://docs.aws.amazon.com/translate/latest/dg/async-prereqs.md): The following prerequisites must be met in order for Amazon Translate to perform a successful batch translation job:
- [Running a job](https://docs.aws.amazon.com/translate/latest/dg/async-start.md): Learn how to run a batch translation job.
- [Monitoring and analyzing](https://docs.aws.amazon.com/translate/latest/dg/async-monitor.md): You can use a job's ID to monitor its progress and get the Amazon S3 location of its output documents.
- [Getting results](https://docs.aws.amazon.com/translate/latest/dg/async-results.md): Once the job's status is COMPLETED or COMPLETED_WITH_ERROR, your output documents are available in the Amazon S3 folder you specified.


## [Customizing your translations](https://docs.aws.amazon.com/translate/latest/dg/customizing-translations.md)

- [Using do-not-translate tags](https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-tags.md): Learn how to use do-not-translate tags in Amazon Translate.

### [Customizing with custom terminology](https://docs.aws.amazon.com/translate/latest/dg/how-custom-terminology.md)

Use custom terminologies along with your translation requests to make sure that your brand names, character names, model names, and other unique content get translated to the desired result.

- [Creating a custom terminology](https://docs.aws.amazon.com/translate/latest/dg/creating-custom-terminology.md): You define custom terminology by creating a terminology file.
- [Using custom terminologies](https://docs.aws.amazon.com/translate/latest/dg/using-ct.md): To use a Custom Terminology when translating text with the TranslateText operation, include the optional TerminologyNames parameter.
- [Case-insensitive matching](https://docs.aws.amazon.com/translate/latest/dg/ct-case-insensitive.md): Amazon Translate matches the source terms in your custom terminology regardless of letter case.
- [Example using SDK for Python (Boto3)](https://docs.aws.amazon.com/translate/latest/dg/examples-ct.md): The following example shows how to use the Custom Terminology operations in Python.
- [Encrypting your terminology](https://docs.aws.amazon.com/translate/latest/dg/protect-terminology.md): Amazon Translate endeavors to protect all your data and your custom terminologies are no different.
- [Best practices](https://docs.aws.amazon.com/translate/latest/dg/ct-best-practices.md): Use following general best practices when using custom terminologies:
- [Using brevity](https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-brevity.md): When translating between languages, there are times when the translation output is longer (in character count) than desired.
- [Masking profanity](https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-profanity.md): When you run translations with Amazon Translate, you can enable the profanity setting to mask profane words and phrases in your translation output.
- [Setting formality](https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-formality.md): Learn how to specify the formality level of your translation output.

### [Customizing with parallel data](https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-parallel-data.md)

Influence the translations from Amazon Translate by providing parallel data, which contains example segments of source text and their translations.

- [Parallel data input files for Amazon Translate](https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-parallel-data-input-files.md): Format your translation examples in an input file so that you can add parallel data to Amazon Translate.
- [Adding parallel data](https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-parallel-data-adding.md): Add parallel data to Amazon Translate by importing a file that contains translation examples.
- [Viewing and managing parallel data](https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-parallel-data-managing.md): Use Amazon Translate to view your parallel data resources, access detailed summaries of them, and update them.


## [Code examples](https://docs.aws.amazon.com/translate/latest/dg/service_code_examples.md)

### [Basics](https://docs.aws.amazon.com/translate/latest/dg/service_code_examples_basics.md)

The following code examples show how to use the basics of Amazon Translate with AWS SDKs.

### [Actions](https://docs.aws.amazon.com/translate/latest/dg/service_code_examples_actions.md)

The following code examples show how to use Amazon Translate with AWS SDKs.

- [DescribeTextTranslationJob](https://docs.aws.amazon.com/translate/latest/dg/example_translate_DescribeTextTranslationJob_section.md): Use DescribeTextTranslationJob with an AWS SDK
- [ListTextTranslationJobs](https://docs.aws.amazon.com/translate/latest/dg/example_translate_ListTextTranslationJobs_section.md): Use ListTextTranslationJobs with an AWS SDK
- [StartTextTranslationJob](https://docs.aws.amazon.com/translate/latest/dg/example_translate_StartTextTranslationJob_section.md): Use StartTextTranslationJob with an AWS SDK
- [StopTextTranslationJob](https://docs.aws.amazon.com/translate/latest/dg/example_translate_StopTextTranslationJob_section.md): Use StopTextTranslationJob with an AWS SDK
- [TranslateText](https://docs.aws.amazon.com/translate/latest/dg/example_translate_TranslateText_section.md): Use TranslateText with an AWS SDK or CLI

### [Scenarios](https://docs.aws.amazon.com/translate/latest/dg/service_code_examples_scenarios.md)

The following code examples show how to use Amazon Translate with AWS SDKs.

- [Build an Amazon Transcribe streaming app](https://docs.aws.amazon.com/translate/latest/dg/example_cross_TranscriptionStreamingApp_section.md): Build an Amazon Transcribe streaming app
- [Building an Amazon Lex V2 chatbot](https://docs.aws.amazon.com/translate/latest/dg/example_cross_LexChatbotLanguages_section.md): Create an Amazon Lex V2 chatbot to engage your website visitors
- [Building an Amazon SNS application](https://docs.aws.amazon.com/translate/latest/dg/example_cross_SnsPublishSubscription_section.md): Build a publish and subscription application that translates messages
- [Create an application to analyze customer feedback](https://docs.aws.amazon.com/translate/latest/dg/example_cross_FSA_section.md): Create an application that analyzes customer feedback and synthesizes audio
- [Get started with translate jobs](https://docs.aws.amazon.com/translate/latest/dg/example_translate_Scenario_GettingStarted_section.md): Get started with Amazon Translate jobs using an AWS SDK


## [Tagging](https://docs.aws.amazon.com/translate/latest/dg/tagging.md)

- [Tagging a new resource](https://docs.aws.amazon.com/translate/latest/dg/tagging-newtags.md): Learn how to modify or delete tags in a resource in Amazon Translate.
- [Viewing, editing, and deleting tags](https://docs.aws.amazon.com/translate/latest/dg/tagging-existingtags.md): Learn how to add tags to your resources in Amazon Translate.


## [Security](https://docs.aws.amazon.com/translate/latest/dg/security.md)

### [Data protection](https://docs.aws.amazon.com/translate/latest/dg/data-protection.md)

Learn how the AWS shared responsibility model applies to data protection in Amazon Translate.

- [Encryption at rest](https://docs.aws.amazon.com/translate/latest/dg/encryption-at-rest.md): For the batch translation jobs that you run with Amazon Translate, your translation input and output are both encrypted at rest.
- [Encryption in transit](https://docs.aws.amazon.com/translate/latest/dg/encryption-in-transit.md): To encrypt data in transit, Amazon Translate uses TLS 1.2 with AWS certificates.

### [Identity and Access Management](https://docs.aws.amazon.com/translate/latest/dg/security-iam.md)

How to authenticate requests and manage access to your Amazon Translate resources.

- [How Amazon Translate works with IAM](https://docs.aws.amazon.com/translate/latest/dg/security_iam_service-with-iam.md): Before you use IAM to manage access to Amazon Translate, learn what IAM features are available to use with Amazon Translate.
- [Identity-based policy examples](https://docs.aws.amazon.com/translate/latest/dg/security_iam_id-based-policy-examples.md): By default, users and roles don't have permission to create or modify Amazon Translate resources.
- [AWS managed policies](https://docs.aws.amazon.com/translate/latest/dg/security-iam-awsmanpol.md): Learn about AWS managed policies for Amazon Translate.
- [Troubleshooting](https://docs.aws.amazon.com/translate/latest/dg/security_iam_troubleshoot.md): Use the following information to help you diagnose and fix common issues that you might encounter when working with Amazon Translate and IAM.

### [Monitoring](https://docs.aws.amazon.com/translate/latest/dg/monitoring-translate.md)

Learn how to monitor the performance of your Amazon Translate solution.

- [Logging Amazon Translate API calls with AWS CloudTrail](https://docs.aws.amazon.com/translate/latest/dg/logging-using-cloudtrail.md): Learn about logging Amazon Translate API calls with AWS CloudTrail.
- [CloudWatch metrics and dimensions for Amazon Translate](https://docs.aws.amazon.com/translate/latest/dg/translate-cloudwatch.md): To monitor your solution's performance, use the Amazon CloudWatch metrics and dimensions for Amazon Translate.
- [Monitoring with EventBridge](https://docs.aws.amazon.com/translate/latest/dg/monitoring-with-eventbridge.md): Automate Amazon Translate with other AWS services by using EventBridge.
- [Compliance validation](https://docs.aws.amazon.com/translate/latest/dg/compliance.md): Learn which compliance programs are in scope for Amazon Translate.
- [Resilience](https://docs.aws.amazon.com/translate/latest/dg/disaster-recovery-resiliency.md): Learn how AWS architecture supports data redundancy, and which Amazon Translate features support data resiliency.
- [Infrastructure security](https://docs.aws.amazon.com/translate/latest/dg/infrastructure-security.md): Learn how Amazon Translate isolates service traffic.
- [VPC endpoints (AWS PrivateLink)](https://docs.aws.amazon.com/translate/latest/dg/vpc-interface-endpoints.md): You can use an interface VPC endpoint to create a private connection between your VPC and Amazon Translate without requiring access over the internet or through a NAT device, a VPN connection, or an Direct Connect connection.


## Full content

The entire guide is also available as a single markdown file, useful for feeding the full guide to an LLM in one pass:

- [Complete guide (single file)](https://docs.aws.amazon.com/translate/latest/dg/full.md)