عمليات ترجمة المستندات
ميزة المرجع
: Azure الذكاء الاصطناعي Translator → Document Translation
ترجمة المستندات هي ميزة مستندة إلى السحابة لخدمة Azure الذكاء الاصطناعي Translator وهي جزء من عائلة خدمة Azure الذكاء الاصطناعي لواجهات برمجة تطبيقات REST. تترجم واجهة برمجة تطبيقات ترجمة المستندات الدفعية المستندات عبر جميع اللغات واللهجات المدعومة مع الحفاظ على بنية المستند وتنسيق البيانات. يتم سرد الأساليب المتوفرة في الجداول التالية:
إصدار واجهة برمجة التطبيقات: 2024-05-01
إشعار
الإصدار الحالي متوافق مع الإصدار القديم.
بدءا من هذا الإصدار الحالي،
get supported storage sourcesيتم دعم الأسلوب لفترة أطول. تدعم خدمة Translator تخزين Azure Blob فقط.
| طلب | الطريقة | الوصف | مسار واجهة برمجة التطبيقات |
|---|---|---|---|
| واحد | متزامن | مستند | ترجمة |
| ترجمة مستند | POST | ترجمة مستند واحد بشكل متزامن. | {document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date} |
| الدفعه | غير متزامن | الوثائق | ترجمة |
| بدء الترجمة | POST | بدء مهمة ترجمة مستند دفعي. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| الحصول على الحالة لجميع مهام الترجمة | GET | طلب قائمة وحالة مهام الترجمة المرسلة من قبل المستخدم. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| الحصول على حالة لمهمة ترجمة معينة | GET | طلب ملخص للحالة لمهمة ترجمة معينة. تتضمن الاستجابة الحالة الإجمالية للوظيفة وحالة المستندات التي تتم ترجمتها كجزء من تلك الوظيفة. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| الحصول على حالة لكافة المستندات | GET | طلب حالة كافة المستندات في مهمة ترجمة. | {document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date} |
| الحصول على حالة لمستند معين | GET | طلب حالة مستند معين في وظيفة. | {document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date} |
| إلغاء الترجمة | حذف | إلغاء مهمة ترجمة المستندات التي يتم حاليا معالجتها أو وضعها في قائمة الانتظار. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| الحصول على تنسيقات المستندات المدعومة | GET | طلب قائمة بتنسيقات المستندات المعتمدة. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=document |
| الحصول على تنسيقات مسرد معتمدة | GET | طلب قائمة بتنسيقات المسرد المعتمدة. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary |
قديم
إشعار
- الإصدار القديم متوافق مع الإصدار الحالي. يمكنك استخدام عمليات أي من الإصدارين لترجمة المستندات.
- نوصي بترحيل تطبيقاتك إلى أحدث إصدار للاستفادة من تجربة محسنة وقدرات متقدمة.
| طلب | الطريقة | الوصف | مسار واجهة برمجة التطبيقات |
|---|---|---|---|
| واحد | متزامن | مستند | ترجمة |
| ترجمة مستند | POST | ترجمة مستند واحد بشكل متزامن. | {document-translation-endpoint}/translator/document:translate?sourceLanguage={source language}&targetLanguage={target language}&api-version=2024-05-01" -H "Ocp-Apim-Subscription-Key:{your-key}" -F "document={path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -F "glossary={path-to-your-glossary-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file}" |
| الدفعه | غير متزامن | الوثائق | ترجمة |
| بدء الترجمة | POST | بدء مهمة ترجمة مستند دفعي. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| الحصول على الحالة لجميع مهام الترجمة | GET | طلب قائمة وحالة مهام الترجمة المرسلة من قبل المستخدم. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| الحصول على حالة لمهمة ترجمة معينة | GET | طلب ملخص للحالة لمهمة ترجمة معينة. تتضمن الاستجابة الحالة الإجمالية للوظيفة وحالة المستندات التي تتم ترجمتها كجزء من تلك الوظيفة. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| الحصول على حالة لكافة المستندات | GET | طلب حالة مستند معين في وظيفة. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents |
| الحصول على حالة لمستند معين | GET | طلب حالة مستند معين في وظيفة. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId} |
| إلغاء الترجمة | حذف | إلغاء مهمة ترجمة المستندات التي يتم حاليا معالجتها أو وضعها في قائمة الانتظار. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| الحصول على تنسيقات المستندات المدعومة | GET | طلب قائمة بتنسيقات المستندات المعتمدة. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats |
| الحصول على تنسيقات مسرد معتمدة | GET | طلب قائمة بتنسيقات المسرد المعتمدة. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats |
| الحصول على مصادر تخزين مدعومة | GET | طلب قائمة بمصادر/خيارات التخزين المدعومة. حاليا، تدعم خدمة Translator تخزين Azure Blob فقط. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources |