json و markdown.
ستقدم هذه الوثيقة شرحًا تفصيليًا لتوصيل واجهة برمجة التطبيقات، لمساعدتك على دمجها بسهولة والاستفادة الكاملة من قوة هذه الواجهة. من خلال واجهة برمجة التطبيقات للترجمة، يمكنك بسهولة ترجمة النص المدخل إلى لغة معينة، وتدعم طرقًا معينة لعرض نتائج الترجمة.
عملية التقديم
لاستخدام واجهة برمجة التطبيقات لترجمة التوطين، يجب أولاً الذهاب إلى وحدة التحكم في Ace Data Cloud للحصول على رمز API الخاص بك، للاحتفاظ به كنسخة احتياطية.
إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد الانتهاء، سيتم إرجاعك تلقائيًا إلى الصفحة الحالية.
يمكن استخدام رمز API واحد لاستدعاء جميع خدمات المنصة، دون الحاجة لتقديم طلب منفصل لكل خدمة. ستتلقى رصيدًا مجانيًا عند الطلب لأول مرة، يمكنك تجربته مجانًا؛ وعند نفاد الرصيد، يمكنك إعادة شحن الرصيد العام في وحدة التحكم.
📘 الوثيقة الكاملة: واجهة برمجة التطبيقات لترجمة التوطين →
مثال على الطلب
سنأخذ مثالاً على إدخال باللغة الإنجليزية، لعرض كيفية استخدام هذه الواجهة. لنفترض أن الوصف باللغة الإنجليزية هو:# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.، وسنوضح كيفية رفع الوصف باللغة الإنجليزية والحصول على نتيجة الترجمة إلى اللغة الصينية، مع عرضها بصيغة markdown.
إعداد رأس الطلب وجسم الطلب
رؤوس الطلب تشمل:accept:تحديد استلام نتائج الاستجابة بصيغة JSON، هنا يتم ملؤها بـapplication/json.authorization:مفتاح استدعاء واجهة برمجة التطبيقات، يمكن اختياره مباشرة بعد التقديم.
input:المحتوى المطلوب ترجمته. عندextension=mdيتم تمرير سلسلة نصية، وعندextension=jsonيتم تمرير كائن JSON.locale:تخصيص لغة الترجمة.extension:تنسيق محتوى الإدخال، يمكن أن يكونmdأوjson.model:النموذج الكبير المستخدم في الترجمة، الافتراضي هو gpt-3.5.
يجب أن يتطابق
extension مع نوع input؛ لا يمكن استخدام السلسلة النصية مع json، ولا يمكن استخدام كائن JSON مع md.
الإعداد كما هو موضح في الصورة أدناه:

مثال على الكود
يمكنك ملاحظة أنه تم توليد أكواد بلغات مختلفة تلقائيًا على الجانب الأيمن، كما هو موضح في الصورة:
CURL
Python
مثال على الاستجابة
بعد نجاح الطلب، ستقوم واجهة برمجة التطبيقات بإرجاع معلومات نتيجة مهمة الترجمة هنا. على سبيل المثال:data، الذي يحتوي على النص المترجم إلى الصينية، كما تم إرجاعه بصيغة markdown، والمعلومات الأخرى كما يلي:
data، نتيجة مهمة الترجمة هنا.model، النموذج اللغوي الكبير المستخدم في مهمة الترجمة هنا.locale، نوع لغة الترجمة لمهمة الترجمة هنا.
معالجة الأخطاء
عند استدعاء واجهة برمجة التطبيقات، إذا واجهت أخطاء، ستقوم الواجهة بإرجاع رمز الخطأ والمعلومات المناسبة. على سبيل المثال:400 token_mismatched:طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صحيحة.400 api_not_implemented:طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صحيحة.401 invalid_token:غير مصرح، رمز التفويض غير صالح أو مفقود.429 too_many_requests:طلبات كثيرة جدًا، لقد تجاوزت الحد الأقصى لمعدل الطلبات.500 api_error:خطأ في الخادم الداخلي، حدث خطأ ما على الخادم.

