Skip to content

Commit dc8b30a

Browse files
authored
Update use-rest-api-programmatically.md
1 parent 78b5742 commit dc8b30a

File tree

1 file changed

+23
-0
lines changed

1 file changed

+23
-0
lines changed

articles/ai-services/translator/document-translation/how-to-guides/use-rest-api-programmatically.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -209,6 +209,29 @@ The following headers are included with each Document Translation API request:
209209
}
210210
```
211211

212+
### 🆕 Translate text embedded in images within documents
213+
214+
> [!Note]
215+
>
216+
> * This feature is optional and must be enabled for each translation request.
217+
> * Enabling this feature will incur additional costs based on usage. For more information, *see* [Azure AI Vision pricing](https://azure.microsoft.com/pricing/details/cognitive-services/computer-vision/)
218+
> * This feature is currently available only with the Batch Document Translation API.
219+
> * The Supported file format is `.docx` only.
220+
> * An Azure AI Services resource (not the standalone Translator resource) is required to use this feature.
221+
222+
### Request configuration
223+
224+
* Use the optional `translateTextWithinImage` parameter in the `options` field
225+
226+
* Data type: Boolean (`true` or `false`)
227+
* Default Boolean setting is `false`. Set the option to `true` to enable image text translation.
228+
229+
* **Response Details**. When the feature is enabled, added image processing information is included with the response:
230+
231+
* **`totalImageScansSucceeded`**. The number of successfully translated image scans.
232+
233+
* **`totalImageScansFailed`**. The number of image scans that failed processing.
234+
212235
## Use code to submit Document Translation requests
213236

214237
### Set up your coding Platform

0 commit comments

Comments
 (0)