الرئيسية › مفاتيح API › Google Gemini
✓ تم التحقق مقابل الصفحات الرسمية لـ Google في 23 سبتمبر 2026. الشاشات والأسعار تتغير: إذا بدا شيء مختلفًا، فثق بما تعرضه لك Google.
مفتاح API من Gemini هو رمز سري يتيح لـ TranslateRocket إرسال نص موقعك إلى Gemini، نموذج الذكاء الاصطناعي من Google، واستلام الترجمة؛ تقدّم Google فئة مجانية بحدود، وفئة مدفوعة تشحن رصيدها مسبقًا.
📖 كلمات ستصادفها
- مفتاح API: رمز سري طويل. من يملكه يمكنه استخدام حصتك (ورصيدك، إن كنت تدفع)، لذا عامله كما تعامل كلمة المرور.
- Google AI Studio: موقع Google حيث تنشئ مفاتيح Gemini، على aistudio.google.com.
- المشروع (Project): حاوية تستخدمها Google لتجميع مفاتيحك وفوترتك. ينشئ AI Studio واحدًا لك تلقائيًا.
- الفئة المجانية / الفئة المدفوعة: الفئة المجانية = بدون بطاقة، بدون رسوم، لكن بحدود أقل. الفئة المدفوعة = تضيف بطاقة وتدفع رصيدًا مسبقًا.
- الرمز (Token): الوحدة التي تحتسب Google التكلفة بها. بالنسبة لـ Gemini، الرمز الواحد يعادل حوالي 4 أحرف.
ما تحتاجه قبل البدء
- حساب Google (يكفي عنوان Gmail).
- للفئة المجانية: بدون بطاقة. الحسابات الجديدة تبدأ في الفئة المجانية.
- للفئة المدفوعة: بطاقة دفع، ودفعة مسبقة بقيمة $5 على الأقل (أو ما يعادلها بعملتك).
- حوالي 5 دقائق.
قبل اختيار الفئة المجانية: تحذيران بصراحة
- قد تستخدم Google نصك. في الفئة المجانية، قد تستخدم Google ما ترسله لتحسين منتجاتها، وقد يقرأه مراجعون بشريون. تقول شروط Google بعدم إرسال معلومات حساسة أو سرية أو شخصية. صفحات موقعك العامة عادةً ليست سرية، لكن فكّر في الأمر إذا كان موقعك يحتوي على محتوى خاص. استثناء: إذا كنت في المنطقة الاقتصادية الأوروبية أو سويسرا أو المملكة المتحدة، تقول Google إن قواعد بيانات الفئة المدفوعة تنطبق عليك حتى في الفئة المجانية.
- الشركات في أوروبا أو المملكة المتحدة: اقرأ هذا السطر في شروط Google. تقول شروط Google إنه عند إتاحة "عميل API" لمستخدمين في المنطقة الاقتصادية الأوروبية أو سويسرا أو المملكة المتحدة، لا يجوز لك استخدام إلا الخدمات المدفوعة فقط. أما إذا كانت ترجمة موقعك الخاص تندرج ضمن ذلك فهي مسألة قانونية لا يمكننا الإجابة عنها نيابةً عنك. إذا لم تكن متأكدًا، فعّل الفوترة (الخطوة 7 أدناه) أو استشر مستشارك.
كذلك، تحتوي الفئة المجانية على حدود لمعدل الاستخدام (عدد الطلبات في الدقيقة واليوم). لا تنشر Google أرقامًا ثابتة في صفحة توثيقها؛ ترى حدودك الخاصة في AI Studio. قد تحتاج المواقع الكبيرة إلى عدة أيام، أو إلى الفئة المدفوعة.
خطوة بخطوة
هذا كل ما تحتاجه للفئة المجانية. للانتقال إلى الفئة المدفوعة (حدود أعلى، ونصك لا يُستخدم لتحسين منتجات Google):
من المفيد معرفته: منذ 28 مايو 2026، كل مفتاح جديد يُنشأ في AI Studio هو من نوع جديد وأكثر أمانًا ("auth key"). تقول Google إنها ترفض المفاتيح القديمة من نوع "standard" اعتبارًا من سبتمبر 2026. إذا كان لديك مفتاح Gemini قديم، أنشئ واحدًا جديدًا.
كم تبلغ التكلفة
الفئة المجانية: مجانية على النماذج التي تقدّمها Google مجانًا، ضمن حدود معدل الاستخدام الخاصة بك.
الفئة المدفوعة — السعر الرسمي (صفحة أسعار Gemini API من Google، تم التحقق منها في 23 سبتمبر 2026)، لكل مليون رمز:
| Model | النص المُرسَل (الإدخال) | النص المُستلَم (الإخراج، بما في ذلك "التفكير") |
|---|---|---|
| Gemini 2.5 Flash-Lite | $0.10 | $0.40 |
| Gemini 3.5 Flash-Lite | $0.30 | $2.50 |
| Gemini 2.5 Flash | $0.30 | $2.50 |
النموذج الافتراضي لـ TranslateRocket هو gemini-flash-lite-latest، اسم تشير به Google إلى أحدث إصدار من Flash-Lite. لا تذكر Google في تلك الصفحة أي إصدار هو حاليًا، لذا تحقق من سعر نموذج Flash-Lite الذي تراه في AI Studio.
ما يعنيه ذلك لموقع صغير. مثالنا: موقع من 20 صفحة يحتوي كل منها على حوالي 600 كلمة (12,000 كلمة، أي حوالي 75,000 حرف)، مترجم إلى لغة واحدة.
- 75,000 حرف تعادل حوالي 19,000 رمز.
- يرسل TranslateRocket أيضًا تعليمات قصيرة مع كل دفعة، وغالبًا ما تكون الترجمات أطول من الإنجليزية. للاحتياط نحتسب 30,000 رمز إدخال و30,000 رمز إخراج. يمكن لنماذج Gemini الأحدث أيضًا "التفكير" قبل الإجابة، وتحتسب Google هذا التفكير كإخراج، لذا قد يكون الرقم الفعلي أعلى.
- الفئة المجانية: $0.
- مدفوع، Gemini 2.5 Flash-Lite: 30,000 × $0.10 / 1,000,000 + 30,000 × $0.40 / 1,000,000 ≈ $0.02.
- مدفوع، Gemini 3.5 Flash-Lite: حوالي $0.08.
الرصيد المدفوع مسبقًا ينتهي بعد 12 شهرًا وهو غير قابل للاسترداد (باستثناء الحالات المحددة التي تذكرها Google).
السلامة (يُرجى القراءة)
1. لا يمكن تحصيل أي مبلغ منك في الفئة المجانية. بدون تفعيل الفوترة، لا تملك Google بطاقة لتحصيل الرسوم منها.
2. في الفئة المدفوعة، اضبط سقفًا للإنفاق.
- في AI Studio، افتح صفحة Spend.
- تحت Monthly spend cap، انقر على Edit spend cap.
- أدخل مبلغًا شهريًا، على سبيل المثال $5، واحفظ.
تصنّف Google هذه الميزة كتجريبية وتحذّر من أن الإنفاق قد يتجاوز السقف لحوالي 10 دقائق قبل التوقف. إذا فعّلت إعادة الشحن التلقائي، اضبط أيضًا Monthly Limit: صفحة Billing في AI Studio ← Manage auto-reload ← وسّع Monthly Limit ← أدخل مبلغًا ← Save. مع رصيد مدفوع مسبقًا وإعادة شحن تلقائي معطّلة، لن تخسر أبدًا أكثر من الرصيد الذي شحنته.
3. اضبط حدًا داخل TranslateRocket أيضًا. في TranslateRocket → AI Translation، القسم Usage & limits، أدخل Daily character limit (على سبيل المثال 200000). عند بلوغ الحد، تتوقف الترجمة بالذكاء الاصطناعي حتى اليوم التالي. 0 تعني بلا حد.
4. لا تشارك المفتاح أبدًا. تقول Google: عامله كما تعامل كلمة المرور. لا تضعه في رسائل بريد إلكتروني أو محادثات أو لقطات شاشة أو تذاكر دعم.
5. إذا اعتقدت أن المفتاح تسرّب (قائمة التحقق الخاصة بـ Google):
- أنشئ مفتاحًا جديدًا في AI Studio والصقه في TranslateRocket.
- عطّل أو احذف المفتاح القديم من صفحة Credentials في Google Cloud console: https://console.cloud.google.com/apis/credentials (اختر المشروع، ثم المفتاح). يمكن استعادة مفتاح محذوف خلال 30 يومًا إذا حذفت المفتاح الخطأ.
- تحقق من استخدامك في AI Studio (Dashboard → Usage) بحثًا عن أي نشاط لا تتعرف عليه.
أين تلصقه في TranslateRocket
- في لوحة تحكم ووردبريس الخاصة بك، افتح TranslateRocket → AI Translation.
- في مربع Provider & keys، ابحث عن البطاقة المسماة Google Gemini.
- الصق مفتاحك في حقل API key.
- في أعلى المربع، اضبط Active provider على Google Gemini.
- اختياري: يمكن ترك حقل Model فارغًا (عندها يستخدم TranslateRocket gemini-flash-lite-latest). زر Load available models يعرض النماذج التي يمكن لمفتاحك استخدامها.
- انقر على Save AI settings في أسفل الصفحة.
تعرض البطاقة الآن شارة Active. يمكنك الترجمة من شاشة Translations، أو صفحة بصفحة في المحرر المرئي.
إذا لم يعمل شيء ما
| ما تراه | ما يعنيه عادةً | ما يجب فعله |
|---|---|---|
| خطأ حول مفتاح غير صالح، أو HTTP 400/403 | تم نسخ المفتاح بشكل خاطئ، أو أنه مفتاح قديم من نوع standard لم تعد Google تقبله، أو أنه مُصنَّف Blocked في AI Studio. | الصقه مجددًا بعناية. إذا استمر الفشل، أنشئ مفتاحًا جديدًا في AI Studio: المفاتيح الجديدة هي النوع المقبول. |
429 RESOURCE_EXHAUSTED |
أرسلت كمية كبيرة جدًا وبسرعة كبيرة: حدود الفئة المجانية، أو (في الفئة المدفوعة) حد سرعة الإنفاق. تُعاد الحدود اليومية عند منتصف الليل بتوقيت المحيط الهادئ. | انتظر وحاول مجددًا لاحقًا، أو ترجم عددًا أقل من الصفحات في المرة الواحدة، أو انتقل إلى الفئة المدفوعة. |
402 Payment Required |
الفئة المدفوعة: رصيدك المدفوع مسبقًا وصل إلى $0. تتوقف جميع المفاتيح المرتبطة بحساب الفوترة ذاك معًا. | صفحة Billing في AI Studio ← Buy credits. |
أسئلة يطرحها الناس
هل مفتاح API من Gemini مجاني؟
نعم، توجد فئة مجانية بدون بطاقة، بحدود لمعدل الاستخدام تراها في Google AI Studio. في الفئة المجانية قد تستخدم Google النص الذي ترسله لتحسين منتجاتها؛ وتُطبَّق قواعد مختلفة في المنطقة الاقتصادية الأوروبية وسويسرا والمملكة المتحدة.
توقف مفتاح API القديم الخاص بي من Gemini عن العمل. لماذا؟
منذ 28 مايو 2026، المفاتيح الجديدة التي تُنشأ في AI Studio هي من نوع جديد وأكثر أمانًا، وتقول Google إنها ترفض المفاتيح القديمة من نوع "standard" اعتبارًا من سبتمبر 2026. أنشئ مفتاحًا جديدًا في AI Studio.
هل Gemini هو نفسه Google Cloud Translation؟
لا. Gemini هو نموذج الذكاء الاصطناعي من Google، بمفاتيح من Google AI Studio. أما Google Cloud Translation فهي الخدمة الاحترافية من Google Translate، بمفاتيح من Google Cloud console وتتطلب تفعيل الفوترة.
كم تكلفة واجهة Gemini API المدفوعة؟
تبدأ الفئة المدفوعة بدفعة مسبقة قدرها $5. باستخدام نماذج Flash-Lite، تكلّف ترجمة موقع من 20 صفحة إلى لغة واحدة حوالي $0.02 إلى $0.08.
أيهما يجب أن أختار؟
راجع صفحة المقارنة لدينا للاطلاع على مقارنة بسيطة بين الخدمات الخمس، وعلى الخيار المجاني الذي لا يحتاج إلى مفتاح على الإطلاق.
أدلة أخرى: OpenAI · Anthropic (Claude) · DeepL · Google Cloud Translation · أيهما يجب أن أختار؟
