Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Terjemahan real-time menggunakan API
<a name="sync-api"></a>

Amazon Translate menyediakan operasi terjemahan real-time berikut untuk mendukung aplikasi interaktif:
+  [TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)— menerjemahkan blok teks.
+  [TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)— menerjemahkan isi file (teks biasa, HTML, atau .docx).

Operasi sinkron ini mengembalikan hasil terjemahan langsung ke aplikasi Anda. Jika Anda menggunakan deteksi bahasa otomatis dengan operasi ini, Anda mungkin dikenakan biaya. Untuk informasi selengkapnya, lihat [Deteksi bahasa otomatis](how-it-works.md#how-to-auto).

## Terjemahkan teks
<a name="sync-api-text"></a>

Gunakan [TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)operasi untuk menerjemahkan satu blok teks.

### Terjemahkan teks menggunakan baris perintah
<a name="sync-api-cli-command-line"></a>

Contoh berikut menunjukkan cara menggunakan [TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)operasi dari baris perintah. Contoh diformat untuk Unix, Linux, dan macOS. Untuk Windows, ganti karakter kelanjutan backslash (\$1) Unix di akhir setiap baris dengan tanda sisipan (^). 

Di baris perintah, masukkan perintah berikut. 

```
aws translate translate-text \
            --region region \
            --source-language-code "en" \
            --target-language-code "es" \
            --text "hello, world"
```

Perintah merespons dengan JSON berikut:

```
{
    "TargetLanguageCode": "es",
    "TranslatedText": "Hola, mundo",
    "SourceLanguageCode": "en"
}
```

### Terjemahkan teks menggunakan file JSON
<a name="sync-api-cli-json-file"></a>

Contoh ini menunjukkan cara menggunakan file JSON untuk menerjemahkan blok teks yang lebih panjang. Anda dapat menentukan sumber dan bahasa target pada baris perintah, atau Anda menentukannya di file JSON.

**catatan**  
Contoh file JSON diformat untuk keterbacaan. Memformat ulang `"Text"` bidang untuk menghapus jeda baris.  
Contoh diformat untuk Unix, Linux, dan macOS. Untuk Windows, ganti karakter kelanjutan backslash (\$1) Unix di akhir setiap baris dengan tanda sisipan (^).

**Untuk menerjemahkan teks menggunakan file JSON**

1. Salin teks berikut ke dalam file JSON yang disebut`translate.json`:

   ```
   {
       "Text": "Amazon Translate translates documents between languages in 
       real time. It uses advanced machine learning technologies 
       to provide high-quality real-time translation. Use it to 
       translate documents or to build applications that work in 
       multiple languages.", 
       "SourceLanguageCode": "en", 
       "TargetLanguageCode": "fr"
   }
   ```

1. Dalam AWS CLI, jalankan perintah berikut:

   ```
   aws translate translate-text \
               --region region \
               --cli-input-json file://translate.json > translated.json
   ```

   Perintah output file JSON yang berisi teks JSON berikut:

   ```
   {
       "TargetLanguageCode": "fr", 
       "TranslatedText": "Amazon Translate traduit les documents entre 
       les langue en temps réel. Il utilise des technologies 
       avancées d'apprentissage de la machine pour fournir 
       une traduction en temps réel de haute qualité. Utilisez-le 
       pour traduire des documents ou pour créer des applications 
       qui fonctionnent en plusieurs langues.", 
       "SourceLanguageCode": "en"
   }
   ```

## Terjemahkan dokumen
<a name="sync-api-document"></a>

Gunakan [TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)operasi untuk menerjemahkan dokumen teks, HTML, atau Word (.docx) dan kembalikan hasil terjemahan langsung ke aplikasi Anda.

Terjemahan dokumen real-time mendukung terjemahan dari bahasa Inggris ke bahasa apa pun yang didukung, dan dari bahasa apa pun yang didukung ke bahasa Inggris. Anda dapat menentukan kode bahasa sumber atau menggunakan deteksi otomatis. 

### Terjemahkan dokumen menggunakan baris perintah
<a name="sync-api-documenti-cli"></a>

Contoh berikut menunjukkan cara menggunakan [TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)operasi dari baris perintah. Contoh diformat untuk Unix, Linux, dan macOS. Untuk Windows, ganti karakter kelanjutan backslash (\$1) Unix di akhir setiap baris dengan tanda sisipan (^). 

Di baris perintah, masukkan perintah berikut. 

```
aws translate translate-document \
            --region region \
            --source-language-code "en" \
            --target-language-code "es" \
            --document-content fileb://source-lang.txt 
            --document ContentType=text/plain 
            --query "TranslatedDocument.Content" 
            --output text | base64 
            --decode > target-lang.txt
```

Perintah merespons dengan JSON berikut:

```
{
    "SourceLanguageCode": "en",
    "TargetLanguageCode": "es",
    "TranslatedDocument":{
      "Content": blob
    }
}
```