مفتاح API

لا يتضمن Transrewrt ذكاءً اصطناعيًا خاصًا به — بل يرسل نصك إلى مزود ذكاء اصطناعي تختاره. لتوصيل مزود، تقوم بإضافة مفتاح API: وهو رمز خاص، يصدره المزود، ويعمل ككلمة مرور لخدمته. تحتاج فقط إلى مزود واحد للبدء، ولا تحتاج إلى الدفع: يقدم العديد من المزودين نماذج مجانية أو مستويات مجانية، ويمكنك أيضًا تشغيل النماذج على جهاز الكمبيوتر الخاص بك بدون أي مفتاح على الإطلاق.

يشمل المزودون المدعومون OpenRouter، وOpenAI، وAnthropic، وGoogle Gemini، وDeepSeek، وGroq، وMistral، وxAI، وCerebras، وNVIDIA، وAlibaba Cloud، وapikey.fun، وأي نقطة نهاية متوافقة مع OpenAI، والخوادم المحلية المتوافقة مع OpenAI (Ollama، وLM Studio، وllama.cpp، وما شابه ذلك).

الخطوة 1 — اختر مزودًا

يعمل أي مزود مدعوم. إذا لم تكن متأكدًا من أي واحد تختار:

• مجاني للبدء: يقدم كل من OpenRouter وGoogle Gemini وGroq وMistral وCerebras وNVIDIA نماذج مجانية أو مستويات مجانية.
• هل لديك حساب بالفعل؟ إذا كنت تستخدم بالفعل OpenAI أو Anthropic أو أي مزود آخر مدعوم، يمكنك ببساطة إعادة استخدام هذا الحساب.
• هل تفضل الاحتفاظ بكل شيء على جهاز الكمبيوتر الخاص بك؟ تخطى المفتاح تمامًا واستخدم نموذجًا محليًا بدلاً من ذلك.

الخطوة 2 — إنشاء مفتاح API

تختلف الخطوات الدقيقة قليلاً حسب المزود، ولكن النمط هو نفسه في كل مكان:

1. قم بالتسجيل أو تسجيل الدخول على موقع الويب الخاص بالمزود. في الإعدادات ← تكوين API في Transrewrt، يحتوي كل مزود على رابط فتح موقع الويب الخاص بالمزود الذي يأخذك إلى المكان الصحيح.
2. ابحث عن صفحة مفاتيح API (أحيانًا تحت إعدادات الحساب أو لوحة التحكم أو المطور) وقم بإنشاء مفتاح جديد. يطلب بعض المزودين منك تسمية المفتاح أو تعيين حد للإنفاق — كلاهما اختياري.
3. انسخ المفتاح. إنه سلسلة طويلة من الحروف والأرقام، وغالبًا ما تبدأ بشيء مثل sk-.

ملاحظة

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

الخطوة 3 — إضافة المفتاح واختباره (سطح المكتب)

1. في Transrewrt، افتح الإعدادات ← تكوين API.
2. الصق المفتاح في الحقل الخاص بمزودك (على سبيل المثال مفتاح API لـ Google Gemini) واحفظه.
3. انقر فوق اختبار بجوار الحقل لتأكيد عمل المفتاح.

بمجرد نجاح الاختبار، تكون جاهزًا — اختر هذا المزود على الشاشة الرئيسية وابدأ الترجمة.

استخدام نموذج محلي بدلاً من ذلك (بدون مفتاح API)

يمكنك تشغيل النماذج على جهاز الكمبيوتر الخاص بك باستخدام Ollama أو LM Studio أو llama.cpp أو أي خادم آخر متوافق مع OpenAI (على سبيل المثال google/gemma-4-e2b عبر LM Studio). لا يغادر أي شيء جهازك ولا يلزم وجود مفتاح API.

لتوصيل واحد، قم بتعيين عنوان URL الأساسي لـ LLM المحلي إلى عنوان URL الأساسي الكامل لواجهة برمجة التطبيقات، بما في ذلك المسار — على سبيل المثال http://localhost:11434/v1. على سطح المكتب، قم بتعيين هذا في الإعدادات ← تكوين API؛ على Docker، قم بتعيين متغير البيئة LOCAL_LLM_URL بدلاً من ذلك.

نصيحة

إذا كنت تستخدم خادم LLM محليًا من جهاز أو حاوية أخرى، فقم بتكوينه للسماح بالاتصالات الخارجية (وليس localhost فقط).

Docker / الويب

إذا كنت تستخدم Transrewrt في متصفح، يتم إدارة المفاتيح بواسطة من يدير الخادم، ولا يتم كتابتها في واجهة المستخدم للمتصفح. يقوم المسؤول بتعيين مفاتيح المزود كـ متغيرات بيئة على الخادم (على سبيل المثال PROVIDER_API_KEY) — راجع التكوين.

قائمة التحقق للتشغيل الأول

1. افتح التطبيق وقم بتعيين لغة الواجهة إذا لزم الأمر.
2. أضف واختبر مفتاح مزود واحد على الأقل — أو قم بتكوين نموذج محلي (سطح المكتب)، أو تأكد من أن الخادم يحتوي على مفاتيح بيئة (الويب).
3. في وضع سهل، اختر مزودًا في الإعدادات العامة؛ في وضع متقدم، أضف نماذج ضمن الإعدادات ← النماذج — راجع الإعدادات للوضعَين.
4. في ترجمة، اختر إعدادًا مسبقًا أو نموذجًا وقم بإجراء اختبار قصير — راجع ترجمة النص.

إذا لم يعمل شيء ما

• فشل اختبار المفتاح: تحقق من نسخ المفتاح بالكامل (لا توجد مسافات قبله أو بعده)، وأنه لم يتم حذفه أو تعطيله على موقع المزود.
• فشل الترجمات بسبب خطأ في الحصة أو الرصيد: المستويات المجانية لها حدود يومية أو شهرية؛ انتظر، أو انتقل إلى مزود مجاني آخر، أو أضف رصيدًا.
• لا يظهر أي مزود في الوضع السهل: افتح الإعدادات ← تكوين واجهة برمجة التطبيقات وتأكد من تكوين وافختبار مفتاح واحد على الأقل (أو عنوان URL لـ LLM المحلي).

مزيد من المساعدة: المشكلات الشائعة.