واجهة برمجة تطبيقات مهام الترجمة
إنشاء مهمة ترجمة
إنشاء مهمة ترجمة جديدة لترجمة الوثائق والملفات.
- العنوان الكامل
- https://otranslator.com/api/v1/translation/create
- المصادقة
- يجب تمرير API Key في رأس طلب Authorization
- Content-Type
- multipart/form-data
- تنسيق خاطئ
- { "error": "Invalid API key." }
ملاحظات
إنشاء المهمة سيدخل فوراً إلى قائمة الانتظار، وسيُرجع taskId. يمكن لاحقاً الحصول على التقدم والتكلفة ورابط التنزيل عبر واجهة الاستعلام عن المهمة.
رصيد نقاط الحساب يحتاج إلى 2 credits على الأقل لإنشاء المهمة. عندما يكون preview بقيمة true يتم توليد المعاينة فقط ودفع نقاط المعاينة.
معامل glossary يطابق حسب اسم المسرد، ويمكن تمرير عدة حقول بنفس الاسم بشكل متكرر لتحديد مسارد متعددة.
مثال
1curl -X POST 'https://otranslator.com/api/v1/translation/create' \
2--header 'Authorization: [yourSecretKey]' \
3--form 'file=@bitcoin.pdf' \
4--form 'fromLang=English' \
5--form 'toLang=Simplified Chinese' \
6--form 'outputFormat=MD' \
7--form 'bilingualMode=Horizontal' معاملات الطلب
| المعاملات | النوع | افتراضي | الوصف | مثال |
|---|---|---|---|---|
| *file | binary | - |
| bitcoin.pdf |
| *fromLang | String | - |
| English |
| *toLang | String | - |
| Simplified Chinese |
| model | String | - |
| - |
| fileDescription | String | - | وصف المستند، من خلال توفير معلومات إضافية، يتم تحسين جودة الترجمة، مثل إضافة معلومات السياق الإضافية للمستند ومتطلبات الترجمة الأخرى وغيرها | - |
| glossary | String | - | اسم قائمة المصطلحات المستخدمة في الترجمة | - |
| preview | Boolean | false | هل سيتم إنشاء المعاينة فقط. عند إنشاء المعاينة فقط، يتم دفع 2 credits لإنشاء معاينة ترجمة المستند | - |
| shouldTranslateImage | Boolean | false |
| - |
| forceOCR | Boolean | false | فرض استخدام OCR للتعرف على محتوى المستند. عند التفعيل سيتم تمكين ترجمة الصور أيضاً. | - |
| shouldTranslateFileName | Boolean | true | هل تريد ترجمة اسم الملف | - |
| strictSourceLanguageCheck | Boolean | false | ترجمة النصوص المحددة باللغة الأصلية فقط. عند التفعيل سيتم تصفية المحتوى غير المكتوب باللغة الأصلية بشكل أكثر صرامة، كما سيُستخدم معامل أكثر صرامة لحساب التكلفة. | - |
| outputFormat | String | - | تنسيق الإخراج. عند إدخال MD سيحاول توليد ترجمة Markdown. | MD |
| bilingualMode | String | Horizontal | اتجاه تخطيط الملف ثنائي اللغة. Horizontal يعني التقابل الأفقي، Vertical يعني التقابل العمودي. | Horizontal |
| password | String | - | كلمة مرور فتح ملف PDF | - |
| ignoreComments | Boolean | false | هل تريد تجاهل التعليقات في ملفات DOCX و PPTX و XLSX | - |
| ignoreNotes | Boolean | false | هل تريد تجاهل الملاحظات في ملفات PPTX | - |
| ignoreHeadersAndFooters | Boolean | false | هل تريد تجاهل تذييل وترويسة الصفحات في ملفات DOCX | - |
| ignoreHidden | Boolean | false | هل تريد تجاهل الشرائح المخفية في ملفات PPTX | - |
| ignoreMasters | Boolean | false | هل تريد تجاهل نص القالب الرئيسي في ملفات PPTX | - |
| ignoreSheetNames | Boolean | false | هل لا تترجم أسماء الجداول في XLSX | - |
| extractTextRegExpPattern | String | - |
| - |
| extractTextRegExpFlags | String | - |
| - |
| allowFlip | Boolean | true | هل يسمح بقلب تخطيط الصفحة للغات التي تكتب من اليمين إلى اليسار. عند تمرير false سيتم إيقاف قلب الصور في نفس الوقت. | - |
| allowFlipImage | Boolean | true | هل يسمح بقلب محتوى الصور للغات التي تكتب من اليمين إلى اليسار. | - |
| webhookUrl | String | - | رابط الاستدعاء المرتد عند تحديث الحالة، يشمل محتوى الاستدعاء: {taskId, progress, status} | - |
الاستجابة
| المعاملات | النوع | افتراضي | الوصف | مثال |
|---|---|---|---|---|
| taskId | String | - | معرف المهمة | - |
الأخطاء الشائعة
401 Missing API key.
The Authorization request header is required.
401 Invalid API key.
The API key does not exist, has been deleted, or is no longer valid.
402 Insufficient credits balance.
The account does not have enough credits to create the task.
400 Missing required parameter: fromLang.
Provide fromLang using a language returned by /api/v1/languages.
400 Missing required parameter: toLang.
Provide toLang using a language returned by /api/v1/languages.
400 Invalid fromLang: [language]. Use a language returned by /api/v1/languages.
The provided source language is not supported.
400 Invalid toLang: [language]. Use a language returned by /api/v1/languages.
The provided target language is not supported.
400 Missing required file upload: file.
Upload the source document in the file form field.
404 Glossary "[name]" not found.
The specified glossary does not exist or does not belong to the current API account.