مزودو الترجمة

يدعم @lingo.dev/compiler مزودي ترجمة متعددين—استخدم محرك Lingo.dev للحصول على أفضل تجربة، أو اتصل مباشرة بمزودي LLM.

محرك Lingo.dev (موصى به)

محرك Lingo.dev هو الطريقة الأسهل والأقوى لترجمة تطبيقك. يوفر:

• اختيار النموذج الديناميكي - يوجه تلقائياً إلى أفضل نموذج لكل زوج لغوي
• الاحتياطيات التلقائية - يتحول إلى النماذج الاحتياطية في حالة فشل النموذج الأساسي
• ذاكرة الترجمة - يأخذ في الاعتبار الترجمات السابقة للحفاظ على الاتساق
• دعم المسرد - يحافظ على المصطلحات الخاصة بالمجال
• تحسين التكلفة - يستخدم نماذج فعالة حيثما كان ذلك مناسباً

الإعداد

1. سجل في lingo.dev

2. المصادقة:

   npx lingo.dev@latest login
   

3. التكوين:

   {
     models: "lingo.dev"
   }
   

التسعير: متوفرة خطة Hobby مجانية. كافية لمعظم المشاريع.

مفتاح API يدوي

إذا فشلت مصادقة المتصفح (مثل متصفح Brave الذي يحظر)، أضف مفتاح API إلى .env:

LINGODOTDEV_API_KEY=your_key_here

ابحث عن مفتاح API الخاص بك في إعدادات المشروع على lingo.dev.

مزودو LLM المباشرون

اتصل مباشرة بمزودي LLM للحصول على تحكم كامل في اختيار النموذج والتكاليف.

المزودون المدعومون

إعداد بسيط

استخدم مزودًا واحدًا لجميع الترجمات:

{
  models: {
    "*:*": "groq:llama-3.3-70b-versatile"
  }
}

تعيين أزواج اللغات

استخدم مزودين مختلفين لأزواج لغات مختلفة:

{
  models: {
    // Specific pairs
    "en:es": "groq:llama-3.3-70b-versatile",    // Fast & cheap for Spanish
    "en:de": "google:gemini-2.0-flash",         // Good quality for German
    "en:ja": "openai:gpt-4o",                   // High quality for Japanese

    // Wildcards
    "*:fr": "anthropic:claude-3-5-sonnet",      // All sources → French
    "en:*": "google:gemini-2.0-flash",          // English → all targets

    // Fallback
    "*:*": "lingo.dev",                         // Everything else
  }
}

أولوية مطابقة الأنماط:

1. مطابقة تامة ("en:es")
2. حرف بدل للمصدر ("*:es")
3. حرف بدل للهدف ("en:*")
4. حرف بدل عام ("*:*")

إعداد مفتاح API

أضف مفاتيح API الخاصة بالمزود إلى .env:

# Lingo.dev Engine
LINGODOTDEV_API_KEY=your_key

# OpenAI
OPENAI_API_KEY=sk-...

# Anthropic
ANTHROPIC_API_KEY=sk-ant-...

# Google
GOOGLE_API_KEY=...

# Groq
GROQ_API_KEY=gsk_...

# Mistral
MISTRAL_API_KEY=...

# OpenRouter
OPENROUTER_API_KEY=sk-or-...

لا تقم أبدًا بإرسال ملفات .env—أضفها إلى .gitignore.

دليل اختيار النموذج

للتطوير

استخدم المترجم الزائف—فوري ومجاني وبدون مفاتيح API:

{
  dev: {
    usePseudotranslator: true,
  }
}

للمشاريع ذات الميزانية المحدودة

Groq - استنتاج سريع وطبقة مجانية سخية:

{
  models: {
    "*:*": "groq:llama-3.3-70b-versatile",
  }
}

Google Gemini - أسعار تنافسية وجودة جيدة:

{
  models: {
    "*:*": "google:gemini-2.0-flash",
  }
}

للجودة العالية

OpenAI GPT-4 - أفضل جودة إجمالية:

{
  models: {
    "*:*": "openai:gpt-4o",
  }
}

Anthropic Claude - ممتاز للترجمات الدقيقة:

{
  models: {
    "*:*": "anthropic:claude-3-5-sonnet",
  }
}

للاستخدام المحلي/دون اتصال

Ollama - تشغيل النماذج محلياً:

{
  models: {
    "*:*": "ollama:llama3.2",
  }
}

قم بتثبيت Ollama وسحب نموذج:

curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.2

استراتيجية مختلطة (موصى بها)

تحسين التكاليف باستخدام نماذج مختلفة لكل لغة:

{
  models: {
    // Fast & cheap for Romance languages
    "en:es": "groq:llama-3.3-70b-versatile",
    "en:fr": "groq:llama-3.3-70b-versatile",
    "en:pt": "groq:llama-3.3-70b-versatile",

    // Higher quality for complex languages
    "en:ja": "openai:gpt-4o",
    "en:zh": "openai:gpt-4o",
    "en:ar": "openai:gpt-4o",

    // Good balance for European languages
    "en:de": "google:gemini-2.0-flash",
    "en:nl": "google:gemini-2.0-flash",

    // Fallback
    "*:*": "lingo.dev",
  }
}

مطالبات ترجمة مخصصة

تخصيص تعليمات الترجمة المرسلة إلى نماذج اللغة الكبيرة:

{
  models: "lingo.dev",
  prompt: `Translate from {SOURCE_LOCALE} to {TARGET_LOCALE}.

Guidelines:
- Use a professional tone
- Preserve all technical terms
- Do not translate brand names
- Maintain formatting (bold, italic, etc.)
- Use gender-neutral language where possible`
}

العناصر النائبة المتاحة:

• {SOURCE_LOCALE}: رمز اللغة المصدر (مثل "en")
• {TARGET_LOCALE}: رمز اللغة الهدف (مثل "es")

يقوم المترجم تلقائياً بإلحاق معلومات السياق حول النص المترجم (الملف، المكون، العناصر المحيطة).

نماذج خاصة بالموفر

OpenAI

"openai:gpt-4o"              // Best quality
"openai:gpt-4o-mini"         // Faster, cheaper
"openai:gpt-4-turbo"         // Previous generation

Anthropic

"anthropic:claude-3-5-sonnet"  // Best quality
"anthropic:claude-3-haiku"     // Faster, cheaper
"anthropic:claude-3-opus"      // Highest quality (expensive)

Google

"google:gemini-2.0-flash"      // Fast, efficient
"google:gemini-1.5-pro"        // Higher quality

Groq

"groq:llama-3.3-70b-versatile"  // Fast inference
"groq:mixtral-8x7b-32768"       // Good quality

Mistral

"mistral:mistral-large"         // Best quality
"mistral:mistral-small"         // Faster, cheaper

OpenRouter

يوفر OpenRouter الوصول إلى أكثر من 100 نموذج. استخدم معرفات النماذج من openrouter.ai/models:

"openrouter:anthropic/claude-3.5-sonnet"
"openrouter:google/gemini-2.0-flash"
"openrouter:meta-llama/llama-3.3-70b"

Ollama

استخدم أي نموذج Ollama:

"ollama:llama3.2"
"ollama:mistral"
"ollama:qwen2.5"

عرض النماذج المتاحة: ollama list

المزودون المتوافقون مع OpenAI

يمكنك استخدام أي واجهة برمجة تطبيقات متوافقة مع OpenAI عن طريق تعيين OPENAI_BASE_URL للإشارة إلى نقطة نهاية المزود. يعمل هذا مع مزودين مثل Nebius وTogether AI وAnyscale وFireworks.

ملاحظة Nebius هو المزود الوحيد المتوافق مع OpenAI الذي تم اختباره رسميًا مع مترجم Lingo.dev. المزودون الآخرون المدرجون أدناه يوفرون واجهات برمجة تطبيقات متوافقة مع OpenAI لكنهم غير مختبرين رسميًا.

الإعداد

1. قم بتعيين متغيرات البيئة:

OPENAI_API_KEY=<your-provider-api-key>
OPENAI_BASE_URL=<provider-api-endpoint>

2. استخدم البادئة openai: مع معرف نموذج المزود:

{
  models: {
    "*:*": "openai:provider-model-id"
  }
}

المزودون المدعومون

الأسئلة الشائعة

أي مزود يجب أن أستخدم؟ ابدأ بمحرك Lingo.dev للبساطة. للتحكم الكامل وتحسين التكلفة، استخدم تعيين أزواج اللغات مع مزودين متعددين.

هل أحتاج إلى مفاتيح API في الإنتاج؟ لا. استخدم buildMode: "cache-only" في الإنتاج—يتم إنشاء الترجمات مسبقًا. راجع أوضاع البناء.

هل يمكنني دمج المزودين؟ نعم. استخدم تعيين أزواج اللغات لتوجيه أزواج لغات مختلفة إلى مزودين مختلفين.

ماذا لو كان مفتاح API الخاص بي غير صالح؟ سيفشل المترجم مع رسالة خطأ واضحة. تحقق من ملف .env الخاص بك وتأكد من أن مفتاح API صحيح للمزود المكوّن.

هل يمكنني استخدام نماذج مخصصة؟ يدعم OpenRouter أكثر من 100 نموذج. يدعم Ollama أي نموذج مثبت محلياً. المزودون الآخرون محدودون بكتالوج نماذجهم.

كيف يمكنني الاختبار دون استدعاءات API؟ قم بتفعيل المترجم الزائف في بيئة التطوير:

{
  dev: { usePseudotranslator: true }
}

ما الفرق في التكلفة بين المزودين؟ يختلف بشكل كبير. يقدم Groq طبقة مجانية سخية. OpenAI GPT-4 بأسعار متميزة. Google Gemini بأسعار تنافسية. راجع صفحة الأسعار لكل مزود.

الخطوات التالية

• أوضاع البناء — التحسين لبيئة التطوير مقابل الإنتاج
• مرجع الإعدادات — جميع خيارات الإعدادات
• أفضل الممارسات — استراتيجيات المزودين الموصى بها