ترجمة المستندات SDK

ترجمة المستندات هي ميزة REST API المستندة إلى السحابة لخدمة Azure الذكاء الاصطناعي المترجم. تتيح واجهة برمجة تطبيقات ترجمة المستندات ترجمة مستند كاملة سريعة ودقيقة من المصدر إلى الهدف، بشكل غير متزامن، باللغات المدعومة وتنسيقات الملفات المختلفة. مجموعة تطوير برامج ترجمة المستندات (SDK) هي مجموعة من المكتبات والأدوات التي تمكنك من دمج إمكانات واجهة برمجة تطبيقات REST لترجمة المستندات بسهولة في تطبيقاتك.

اللغات المدعومة

تدعم Document Translation SDK لغات البرمجة التالية:

إصدار لغة ⭠ SDK	الحزمة	مكتبة العميل	إصدار واجهة برمجة التطبيقات المدعوم
.NET/C# → 1.0.0	NuGet	Azure SDK ل .NET	Document Translation v1.1
Python → 1.0.0	PyPi	Azure SDK ل Python	Document Translation v1.1

سجل التغيير ومحفوظات الإصدار

يوفر هذا القسم وصفا مستندا إلى الإصدار لميزة ترجمة المستندات وإصدارات القدرات والتغييرات والتحديثات والتحسينات.

C#/.NET

الإصدار 1.0.0 (GA)
2022-06-07

سجل التغيير/محفوظات الإصدار

التمهيدي

عينات

Python

الإصدار 1.0.0 (GA)
2022-06-07

سجل التغيير/محفوظات الإصدار

التمهيدي

عينات

استخدام Document Translation SDK في تطبيقاتك

تمكن Document Translation SDK من استخدام خدمة الترجمة وإدارتها في التطبيق الخاص بك. تعتمد SDK على واجهات برمجة تطبيقات REST لترجمة المستندات الأساسية لاستخدامها ضمن نموذج لغة البرمجة. اختر لغة البرمجة المفضلة لديك:

1. تثبيت مكتبة عميل عدة تطوير البرامج

C#/.NET

dotnet add package Azure.AI.Translation.Document --version 1.0.0

Install-Package Azure.AI.Translation.Document -Version 1.0.0

Python

pip install azure-ai-translation-document==1.0.0

2. استيراد مكتبة عميل عدة تطوير البرامج إلى التطبيق

C#/.NET

using System;
using Azure.Core;
using Azure.AI.Translation.Document;

Python

from azure.ai.translation.document import DocumentTranslationClient
from azure.core.credentials import AzureKeyCredential

3. مصادقة العميل

C#/.NET

أنشئ مثيلا للكائن DocumentTranslationClient للتفاعل مع Document Translation SDK، ثم قم باستدعاء أساليب على كائن العميل هذا للتفاعل مع الخدمة. DocumentTranslationClient هي الواجهة الأساسية لاستخدام مكتبة عميل ترجمة المستندات. يوفر كلا من الأساليب المتزامنة وغير المتزامنة لتنفيذ العمليات.

private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";

DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(key));

Python

أنشئ مثيلا للكائن DocumentTranslationClient للتفاعل مع Document Translation SDK، ثم قم باستدعاء أساليب على كائن العميل هذا للتفاعل مع الخدمة. DocumentTranslationClient هي الواجهة الأساسية لاستخدام مكتبة عميل ترجمة المستندات. يوفر كلا من الأساليب المتزامنة وغير المتزامنة لتنفيذ العمليات.

endpoint = "<endpoint>"
key = "<apiKey>"

client = DocumentTranslationClient(endpoint, AzureKeyCredential(key))

4. إنشاء التطبيق

C#/.NET

تتطلب واجهة Document Translation الإدخال التالي:

1. قم بتحميل ملفاتك إلى حاوية مصدر Azure Blob Storage (sourceUri).
2. توفير حاوية هدف حيث يمكن كتابة المستندات المترجمة (targetUri).
3. قم بتضمين رمز اللغة الهدف (targetLanguage).

Uri sourceUri = new Uri("<your-source container-url");
Uri targetUri = new Uri("<your-target-container-url>");
string targetLanguage = "<target-language-code>";

DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage)

Python

تتطلب واجهة Document Translation الإدخال التالي:

1. قم بتحميل ملفاتك إلى حاوية مصدر Azure Blob Storage (sourceUri).
2. توفير حاوية هدف حيث يمكن كتابة المستندات المترجمة (targetUri).
3. قم بتضمين رمز اللغة الهدف (targetLanguage).

sourceUrl = "<your-source container-url>"
targetUrl = "<your-target-container-url>"
targetLanguage = "<target-language-code>"

poller = client.begin_translation(sourceUrl, targetUrl, targetLanguage)
result = poller.result()

خيارات المساعدة

Microsoft Q&A تتوفر منتديات و Stack Overflow لمجتمع المطورين لطرح الأسئلة والإجابة عليها حول ترجمة نص Azure والخدمات الأخرى. تراقب Microsoft المنتديات وتجيب على الأسئلة التي لم يُجِب المجتمع عليها.

تلميح

للتأكد من أننا نرى سؤال Microsoft Q&A الخاص بك، ضع علامة عليه باستخدام microsoft-translator. للتأكد من أننا نرى سؤال Stack Overflow الخاص بك، ضع علامة عليه باستخدام Azure AI Translator.

الخطوات التالية

مرجع واجهة برمجة تطبيقات REST لترجمة المستندات SDK لترجمةالمستندات الإصدار 1.1