الانتقال إلى المحتوى الرئيسي
الوظيفة الرئيسية لواجهة برمجة التطبيقات لترجمة التوطين هي الحصول على النص المترجم من خلال إدخال النص المطلوب ترجمته، كما يمكن تخصيص اللغة المترجم إليها، ويمكن أن تكون نتائج الترجمة بصيغتي json و markdown. ستتناول هذه الوثيقة بالتفصيل تعليمات توصيل واجهة برمجة التطبيقات لترجمة التوطين، لمساعدتك على دمجها بسهولة والاستفادة الكاملة من قوة هذه الواجهة. من خلال واجهة برمجة التطبيقات لترجمة التوطين، يمكنك بسهولة ترجمة النص المدخل إلى لغة معينة، وتدعم طرق معينة لعرض نتائج الترجمة.

​
عملية التقديم

لاستخدام واجهة برمجة التطبيقات لترجمة التوطين، يجب أولاً الذهاب إلى صفحة التقديم Localization Translate API لتقديم طلب الخدمة المناسبة، بعد الدخول إلى الصفحة، انقر على زر “Acquire” كما هو موضح في الصورة: صفحة التقديم إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، سيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، بعد تسجيل الدخول أو التسجيل، سيتم العودة تلقائيًا إلى الصفحة الحالية. عند التقديم لأول مرة، ستحصل على حصة مجانية يمكن استخدامها مجانًا.

​
مثال على الطلب

سنأخذ إدخالًا باللغة الإنجليزية كمثال، لعرض كيفية استخدام هذه الواجهة. لنفترض أن الوصف باللغة الإنجليزية هو: # Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.، وسنوضح بعد ذلك كيفية رفع الوصف باللغة الإنجليزية والحصول على نتيجة الترجمة إلى اللغة الصينية، مع عرضها بصيغة markdown.

​
إعداد رأس الطلب وجسم الطلب

Request Headers تشمل:
  • accept: تحديد استلام نتائج الاستجابة بصيغة JSON، هنا يتم ملؤها بـ application/json.
  • authorization: مفتاح استدعاء واجهة برمجة التطبيقات، يمكن اختياره مباشرة بعد التقديم.
Request Body تشمل:
  • input: النص المطلوب ترجمته.
  • locale: اللغة المخصصة للترجمة.
  • extension: الشكل المخصص لعرض نتيجة الترجمة.
  • model: النموذج الكبير المستخدم في الترجمة، الافتراضي هو gpt-3.5.
الإعداد كما هو موضح في الصورة أدناه:

​
مثال على الكود

يمكن ملاحظة أنه تم توليد أكواد بلغات مختلفة تلقائيًا على الجانب الأيمن من الصفحة، كما هو موضح في الصورة:

بعض أمثلة الكود كما يلي:

​
CURL

curl -X POST 'https://api.acedata.cloud/localization/translate' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
  "locale": "zh-CN",
  "extension": "md"
}'

​
Python

import requests

url = "https://api.acedata.cloud/localization/translate"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
    "locale": "zh-CN",
    "extension": "md"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
مثال على الاستجابة

بعد نجاح الطلب، ستقوم واجهة برمجة التطبيقات بإرجاع معلومات نتيجة هذه المهمة الترجمة. على سبيل المثال: 
{
  "data": "# 标题 1\n\n这是一个段落。\n\n## 标题 2\n\n这是另一个段落。",
  "usage": {
    "prompt_tokens": 172,
    "completion_tokens": 25
  },
  "model": "gpt-3.5-turbo-16k",
  "locale": "zh-CN"
}
يمكنك أن ترى أن النتيجة تحتوي على حقل data، والذي يحتوي على النص المترجم إلى الصينية، كما تم إرجاعه بصيغة markdown، والمعلومات الأخرى كما يلي:
  • data، نتيجة مهمة الترجمة هنا.
  • model، النموذج اللغوي الكبير المستخدم في مهمة الترجمة هنا.
  • locale، نوع لغة الترجمة لمهمة الترجمة هنا.

​
معالجة الأخطاء

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

​
مثال على استجابة الخطأ

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
الخاتمة

من خلال هذه الوثيقة، أصبحت على دراية بكيفية استخدام واجهة برمجة التطبيقات لترجمة التوطين بسهولة لترجمة النص المدخل إلى لغة معينة، وتدعم طرق معينة لعرض نتائج الترجمة. نأمل أن تساعدك هذه الوثيقة في توصيل واستخدام هذه الواجهة بشكل أفضل. إذا كان لديك أي استفسارات، فلا تتردد في الاتصال بفريق الدعم الفني لدينا.