Skip to content

Commit 8a3db50

Browse files
Merge pull request #4825 from laujan/patch-3
Update translate-api.md
2 parents 6eae938 + 77f2b77 commit 8a3db50

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

articles/ai-services/translator/text-translation/reference/v4/translate-api.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -56,19 +56,19 @@ Request parameters passed with the request are as follows:
5656
| **language** | string | False | Specifies the language code for the `source` text. If not specified, the system autodetects the language of the source text. Accepted values are list of language code supported by the specified model. |
5757
| **script** | string | False | Specifies the script of the source text. |
5858

59-
#### Targets array (user-specificed values for the translaated text)
59+
#### Targets array (user-specified values for translated text)
6060

6161
| Parameter | Type | Required? | Description |
6262
| --- | --- | --- | --- |
6363
| **targets.language** | string | True |The language code for the translated (`target`) text *specified in the `targets` array*. Accepted values are [supported language](../../../language-support.md) codes for the translation operation.|
6464
| **targets.script** | string | False | Specify the script of the translated text. |
65-
|**targets.deploymentName** | string | False | Default is `general`, which uses `NMT` system. `your-model-name-gpt-4o-mini` is an example deployment name for the GPT-4o-mini model. `gpt-4o` uses GPT-4o model.<br`<custom model id>` uses the custom `NMT` model tuned by customer.<br> |
66-
| **targets.allowFallback** | string | False | If the desired model does not support a particular pair of source and target languages, an alternative approach may be employed. In such cases, the service may default to utilizing a general system as a substitute. This action ensures that translations can still be provided even when the preferred model is unavailable. Default is `true`. If `false` system returns an error if language pair isn't supported. |
65+
|**targets.deploymentName** | string | False | Default is `general`, which uses `NMT` system. `your-model-name-gpt-4o-mini` is an example deployment name for the GPT-4o-mini model. `gpt-4o` uses GPT-4o model.<br`<categoryID>` uses the custom `NMT` model tuned by customer.<br> |
66+
| **targets.allowFallback** | string | False | If the desired model doesn't support a particular pair of source and target languages, an alternative approach may be employed. In such cases, the service may default to utilizing a general system as a substitute. This action ensures that translations can still be provided even when the preferred model is unavailable. Default is `true`. If `false` system returns an error if language pair isn't supported. |
6767
| **targets.tone** | string | False | Desired tone of target translation. Accepted values are `formal`, `informal`, or `neutral`. |
6868
| **targets.gender** (For more information, *see* [Gender-specific translations](#gender-specific-translations))| string | False | Desired gender of target translation. Accepted values are `male`, `female`, or `neutral`.|
69-
| **targets.adaptiveDatasetId** | string | False | Reference dataset ID having sentence pair to generate adaptive customized translation |
70-
| **targets.referenceTextPairs** | string | False | Reference text pairs to generate adaptive customized translation |
71-
| **targets.referenceTextPairs.source** | string | False | Source text in reference text pair. If provided, `adaptiveDatasetId` is ignored |
69+
| **targets.adaptiveDatasetId** | string | False | Reference dataset ID having sentence pair to generate adaptive customized translation. The maximum number of reference text pairs to generate adaptive customized translation is five (5).|
70+
| **targets.referenceTextPairs** | string | False | Reference text pairs to generate adaptive customized translation. |
71+
| **targets.referenceTextPairs.source** | string | False | Source text in reference text pair. If provided, `adaptiveDatasetId` is ignored. |
7272
| **targets.referenceTextPairs.target** | string | False | Target text in reference text pair. |
7373
| **targets.profanityAction** | string | False | Specifies how profanities should be treated in translations. Accepted values are: `NoAction` (default), `Marked`, or `Deleted`. |
7474
| **targets.profanityMarker** | string | False | Specifies how profanities should be marked in translations. Accepted values are `Asterisk` (default) or Tag. |
@@ -481,7 +481,7 @@ Adaptive custom translation deploys on Translator service infrastructure. Charge
481481
"targets": [
482482
{
483483
"language": "es",
484-
"deploymentName": "CT-model-en-es-hr-020"
484+
"deploymentName": "f16e83fb-3af8-4d45-9290-10a516f9dfc4-GENERAL"
485485
}
486486
]
487487
}
@@ -517,4 +517,4 @@ Adaptive custom translation deploys on Translator service infrastructure. Charge
517517
## Next steps
518518

519519
> [!div class="nextstepaction"]
520-
> [View 2025-05-01-preview migration guide](../../how-to/migrate-to-v4.md)
520+
> [View 2025-05-01-preview migration guide](../../how-to/migrate-to-v4.md)

0 commit comments

Comments
 (0)