تخطَّ إلى المحتوى

ترجمة فورية

POST /api/v1/ai/translate-snippet
{
"text": "Hello world",
"source_lang": "auto",
"target_lang": "zh",
"engine": "xr-397b"
}

text يتراوح بين 1 و5000 حرف. يجب أن تكون target_lang وsource_lang (باستثناء auto) رموز لغات مدعومة، وإلا فستكون 422. الاستجابة:

{ "translated_text": "你好,世界", "source_lang": "auto", "target_lang": "zh" }
POST /api/v1/ai/translate-batch
{
"segments": [
{ "id": "p1", "text": "First paragraph." },
{ "id": "p2", "text": "Second paragraph." }
],
"target_lang": "zh"
}
  • يحتوي segments على 1–64 مقطع، بحد أقصى 4000 حرف لكل مقطع؛ وكل id فريد ضمن الطلب (1–64 حرفًا). يؤدي وجود عدد كبير جدًا من المقاطع أو طول أحد المقاطع إلى حدّه الأقصى إلى إرجاع 413.
  • ترد الاستجابة بـ segments: [{ "id", "translated_text" }] وفق ترتيب الطلب.
  • يتم إرجاع المقاطع التي تحتوي على مسافات فارغة فقط كما هي ولا تُفرض عليها أي رسوم.
  • يقتصر حجم جسم الطلب على 2 ميغابايت، ويستمر تنفيذ الطلب لمدة أقصاها 180 ثانية؛ لذا اضبط مهلة العميل بحيث لا تقل عن 180 ثانية.
  • أرسل Idempotency-Key. بعد انقطاع الشبكة أو انتهاء المهلة، أعد المحاولة باستخدام نفس المفتاح ونفس النص؛ لن يتم فرض رسوم مرتين.
  • تُعيد engine غير المتوفرة 400؛ وإذا كانت المفاتيح تحتوي على إعدادات مسموح بها لا تشمل الإعداد المختار، فـ 403.
  • تُحتسب الفاتورة بناءً على كمية النص المصدر التي تمت معالجتها فعليًا.
POST /api/v1/ai/ocr

ارفع الصورة في حقل file ضمن multipart/form-data (PNG, JPEG, WebP, BMP, GIF، بحد أقصى 12 ميغابايت و25 مليون بكسل)، أو أرسل الصورة كجسم للطلب. يُرجع الرد النص سطرًا بسطر مع إحداثيات البكسل:

{
"width": 640,
"height": 240,
"engine": "omnidoc-ocr",
"blocks": [
{ "text": "编号 INV-20261029-0042", "confidence": 0.97, "x": 23, "y": 76, "w": 366, "h": 33 }
]
}
  • x و y هما الزاويتان العلويتان اليسرى لسطر النص، بحسب إحداثيات الصورة المرفوعة (يتم قراءة JPEG المزود ببيانات الاتجاه بشكل مستقيم).
  • كل مربع في سطر منفصل؛ confidence هو مستوى ثقة التعرف على ذلك السطر (من 0 إلى 1). إذا لم يتم العثور على نص، تكون الاستجابة 200 مع blocks فارغة.
  • لا تُحتسب تكلفة التعرف على نص الصورة من الرصيد. الصور التي يقل عرضها أو طولها عن 11 بكسل تُرجع نتيجة فارغة.
  • إذا لم تكن خدمة التعرف متاحة مؤقتًا، تكون الاستجابة 503؛ وفي حالة انتهاء المهلة 504، مع شرح باللغة الصينية في detail؛ يُرجى المحاولة مرة أخرى لاحقًا.
  • يمكن لتسجيل الدخول الخاص بامتداد الترجمة على الويب (omnidoc.translate.use) ومفاتيح واجهة برمجة التطبيقات وتسجيل الدخول عبر المتصفح جميعًا استدعاؤه.
  • تُحتفظ بمعاملات الاستعلام engine وscene وlang لإصدارات الامتداد الأقدم ولا تؤثر في النتيجة.
  • للحصول على صور مترجمة مباشرةً، قم بتحميل الصورة وإنشاء مهمة ترجمة.

نقاط النهاية المتقاعدة

Section titled “نقاط النهاية المتقاعدة”

POST /api/v1/ai/notes و/ai/chat و/ai/generate مُقَلَّعَة وتُعيد 410.