إعدادات API

API Settings في الشريط الجانبي الأيسر هي لوحة التحكم للاستخدام المباشر لواجهة برمجة التطبيقات. يقرأ تطبيق سطح المكتب معظم هذه القيم نيابة عنك؛ وتوجد هذه الشاشة من أجل الحالات التي ترغب فيها باستدعاء واجهة برمجة التطبيقات بنفسك من CI أو من سكربت أو من تكامل خارجي.

شاشة API Settings — بطاقة API Token مع رمز مقنّع وأزرار Copy/Rotate Token، وبطاقة AI Credits تعرض بقاء 5,000 من 5,000 حرف مع تاريخ التجديد، ومحدد AI Engine مع أزرار Gemini/Claude/Mistral/DeepSeek، وبطاقة Rate Limit تعرض 60 طلباً/دقيقة، وبطاقة مثال cURL، وحقل إدخال Depletion Webhook.

رمز API

كل حساب TranSFlator له رمز API واحد — سلسلة عشوائية طويلة تصادق على حسابك أمام واجهة برمجة التطبيقات للترجمة.

تعرض بطاقة الرمز القيمة الحالية مقنّعة افتراضياً، مع إجراءين:

Copy (نسخ) — ينسخ الرمز الكامل إلى الحافظة. تعامل معه كما تتعامل مع كلمة مرور.
Rotate Token (تدوير الرمز) — يُلغي الرمز الحالي ويُصدر رمزاً جديداً. استخدم هذا إذا اشتبهت في تسرب الرمز (دُفع إلى مستودع عام، أو نُشر في محادثة، أو تُرك في ملف سجل) أو كجزء من سياسة تدوير منتظمة.

بعد التدوير، سيحصل أي تطبيق سطح مكتب أو سكربت لا يزال يحمل الرمز القديم على HTTP 401 Unauthorized عند الاستدعاء التالي وسيحتاج إلى تسجيل الدخول / تحديث تهيئته.

أرصدة الذكاء الاصطناعي

مرآة لبطاقة رصيد لوحة القيادة، تظهر هنا لأن مستخدمي API المباشرين غالباً ما يرغبون في رؤيتها بجانب الرمز ومنتقي المحرك. تعرض الأحرف المتبقية وسقف الخطة وتاريخ التجديد.

محرك الذكاء الاصطناعي

اختر النموذج الذي يُشغّل الترجمات المبدوءة عبر API:

Gemini — نموذج Google متعدد اللغات للأغراض العامة.
Claude — Anthropic، دقيق ومدرك للسياق.
Mistral — أوروبي، متوافق مع GDPR، قوي في اللغات الأوروبية.
DeepSeek — فعّال من حيث التكلفة وقوي في CJK.

ينطبق الاختيار على كل استدعاء POST /translate/batch لا يتجاوز engine في جسمه. تغيير المحرك هنا يحدّث أيضاً preferred_ai_model في مستند المستخدم، بحيث يلتقطه تطبيق سطح المكتب في المرة التالية التي يقوم فيها بإعادة التحميل.

حد المعدل

يعرض حد المعدل الحالي لكل رمز (افتراضياً 60 طلباً/دقيقة). الدفعات فوق هذا الحد تعيد HTTP 429 Too Many Requests — تراجع وأعد المحاولة. يُطبَّق الحد لكل رمز API، وليس لكل عنوان IP، لذلك فإن تدوير الرموز لا يُعيد تعيينه.

مثال cURL

استدعاء مثال جاهز للنسخ، مملوء مسبقاً برمزك ويشير إلى نقطة نهاية الترجمة بالدفعات:

curl -X POST https://api.transflator.com/translate \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello world","source_lang":"en","target_lang":"pl"}'

انقر على Copy (نسخ) في البطاقة للحصول عليه مع الرمز الحقيقي بدلاً من العنصر النائب. الاستجابة هي كائن JSON يحتوي على السلسلة المترجمة وبيانات وصفية عن المحرك الذي أنتجها.

Webhook نفاد الرصيد

اختياري. الصق عنوان URL من نوع HTTPS وسنرسل حمولة JSON عبر POST إليه عند وصول رصيدك إلى الصفر. مفيد من أجل:

استدعاء فريق المناوبة عندما يجف تكامل API في الإنتاج.
تشغيل شحن تلقائي في نظام الفوترة الخاص بك.
إرسال إشعار إلى Slack عبر incoming webhook.

اترك الحقل فارغاً لتعطيله. يُطلق webhook مرة واحدة لكل حدث نفاد (وليس عند كل 429 بعد ذلك)؛ ويُعاد تسليحه عند الشحن التالي أو التجديد.