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

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

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

أمثلة الطلب

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

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

Request Headers تشمل:
  • accept: تحديد استلام استجابة بتنسيق JSON، هنا يتم ملؤه بـ application/json.
  • authorization: مفتاح استدعاء الواجهة، يمكن اختياره مباشرة بعد التقديم.
Request Body تشمل:
  • content: الوصف المرفوع باللغة الصينية.
يكفي هذا الحقل الواحد لإكمال الترجمة، يرجى التأكد من أن content يستخدم الوصف باللغة الصينية.
الإعداد كما هو موضح في الصورة أدناه:

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

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

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

CURL

curl -X POST 'https://api.acedata.cloud/midjourney/translate' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "content": "精致,无暇,洁白的天使"
}'

Python

import requests

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

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

payload = {
    "content": "精致,无暇,洁白的天使"
}

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

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

بعد نجاح الطلب، ستقوم الواجهة بإرجاع وصف مترجم باللغة الإنجليزية. على سبيل المثال:
{
  "content": "Exquisite, flawless, pure white angel"
}
يمكنك أن ترى أن النتيجة تحتوي على حقل content، والذي يحتوي على الوصف المترجم باللغة الإنجليزية، وهو نتيجة الترجمة المقابلة للوصف باللغة الصينية.
  • content، يتم إنشاء الوصف المقابل باللغة الإنجليزية، ويمكن استخدامه لوصف مهام توليد الصور.

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

عند استدعاء الواجهة، إذا واجهت أخطاء، ستقوم الواجهة بإرجاع رمز الخطأ والمعلومات المناسبة. على سبيل المثال:
  • 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"
}

الخاتمة

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