الحصول على Gemini API مجاني وغير محدود

تُعد عائلة Gemini من Google هي خط النماذج الحدودية الأكثر فعالية من حيث التكلفة لأحمال العمل ذات الحجم الكبير، حيث تبلغ تكلفة Gemini 2.5 Pro 1.25 دولارًا / 10 دولارات لكل مليون رمز مميز، وتعمل إصدارات Flash بتكلفة أقل بكثير. بالنسبة لتطبيق عام مجاني، أو مشروع جانبي، أو بناء هاكاثون، فإن هذه الأسعار تتراكم بسرعة بمجرد وصول بضعة آلاف من المستخدمين إلى نقطة النهاية الخاصة بك. يقوم Puter.js بقلب النموذج: فهو يكشف عن تشكيلة Gemini بأكملها (2.5 Pro، 2.5 Flash، 2.0 Flash، معاينة 3 Flash، بالإضافة إلى عائلة Gemma 2/3/4 المفتوحة) بدون مفتاح Google API ويحاسب المستخدم النهائي بدلاً منك. بالنسبة للمطور، الواجهة مجانية وغير محدودة.

زر

الخلاصة

Puter.js يمنح المطورين وصولاً مجانيًا وغير محدود إلى كتالوج Gemini و Gemma الكامل بدون مفتاح Google API، ولا مشروع Google Cloud، ولا خادم.
إصدارات Gemini المدعومة: **2.5 Pro, 2.5 Flash, 2.5 Flash Lite, 2.0 Flash, 2.0 Flash Lite, 3 Flash Preview**، بالإضافة إلى معاينات سابقة.
إصدارات Gemma المدعومة: **Gemma 2, 3, 4** بأحجام متعددة (4B, 12B, 27B, 31B, 26B-A4B).
علامة <script> واحدة، استدعاء دالة واحدة، وتتحدث إلى Gemini.
يتيح المتصفح العمل بكل من البث المباشر، إدخال الرؤية، والتحكم في درجة الحرارة.
يغطي المستخدم النهائي استخدامه من حساب Puter؛ تدفع صفرًا، إلى الأبد.
استخدم Apidog لمقارنة أداء Puter مقابل واجهة برمجة تطبيقات Gemini الرسمية لتخطيط الترحيل.

كيف يعمل "مجاني وغير محدود"

يعكس Puter.js نموذج الفوترة لنماذج اللغات الكبيرة (LLM). فبدلاً من أن تحتفظ بمفتاح Google AI Studio وتتحمل تكلفة كل رمز مميز، يقوم المستخدم النهائي بتسجيل الدخول إلى Puter (حساب مجاني) ويتم خصم تكلفة الاستدعاء من رصيده. تحصل حسابات Puter الجديدة على رصيد بدء تشغيل؛ ويقوم المستخدمون بإعادة الشحن إذا أرادوا المزيد.

بالنسبة للمطور، النتائج واضحة:

لا مشروع Google Cloud، ولا مفتاح AI Studio. لا تفاوض على الحصص، لا تدوير للمفاتيح، لا علاقة فوترة.
لا يوجد حد للاستخدام من جانبك. "حدك" يتناسب خطيًا مع قاعدة المستخدمين لديك.
لا يوجد اعتماد على مورد Google للفوترة. Puter يتولى الاستدعاء الأساسي.

المفاضلة: هذا يعتمد على المتصفح أولاً. لا يمكن لوظيفة Cron في الواجهة الخلفية استخدام Puter بدون جلسة مستخدم مسجّل الدخول.

الخطوة 1: التثبيت

علامة CDN واحدة، لا توجد خطوة بناء:

<script src="https://js.puter.com/v2/"></script>

هذا هو التثبيت بالكامل. أو لتطبيق مجمع:

npm install @heyputer/puter.js

import { puter } from '@heyputer/puter.js';

الخطوة 2: اختيار نموذج

تشكيلة Gemini على Puter، مع الأداة المناسبة لكل شكل:

معرف النموذج	متى تستخدمه
`google/gemini-2.5-pro`	لأعمق استنتاج؛ التحليل المعقد ومهام السياق الطويل
`google/gemini-2.5-flash`	النموذج الافتراضي للاستخدام اليومي؛ توازن قوي بين التكلفة والجودة
`google/gemini-2.5-flash-lite`	أرخص متغير من Flash؛ لتصنيف حجم كبير
`google/gemini-2.0-flash`	أساس مستقر؛ سلوك مفهوم جيدًا
`google/gemini-3-flash-preview`	أحدث معاينة؛ سرعة متطورة
`google/gemma-3-27b-it`	جيمّا المفتوحة؛ مضبوطة للتعليمات، جيدة لضبط خطوط الأساس
`google/gemma-4-31b-it`	أكبر جيمّا مفتوحة؛ أقرب إلى جودة Gemini المغلقة

بالنسبة لمعظم التطبيقات، استخدم **`gemini-2.5-flash`** افتراضيًا، ولا تلجأ إلى Pro إلا في المطالبات الصعبة. تعد متغيرات Lite أسرع بكثير وتكفي للوسم والتصنيف والأسئلة والأجوبة البسيطة.

الخطوة 3: اجعل Gemini يتحدث

الاستدعاء الأدنى القابل للتطبيق:

<!DOCTYPE html>
<html>
<body>
  <script src="https://js.puter.com/v2/"></script>
  <script>
    puter.ai.chat(
      "Explain machine learning in three sentences",
      { model: 'google/gemini-2.5-flash' }
    ).then(response => {
      puter.print(response);
    });
  </script>
</body>
</html>

افتح في المتصفح. يتعامل Puter مع الاستدعاء، يقوم المستخدم بتسجيل الدخول (أو ينشئ حساب Puter مجاني عند التشغيل الأول)، وتُطبع الاستجابة على الصفحة. لا يوجد مفتاح API، لا متغير بيئة، لا خادم.

الخطوة 4: بث الاستجابة

بالنسبة لواجهات مستخدم الدردشة والإجابات الطويلة، البث هو الخيار الافتراضي الصحيح:

const response = await puter.ai.chat(
  "Explain photosynthesis in detail",
  {
    model: 'google/gemini-2.5-flash',
    stream: true,
  }
);

for await (const part of response) {
  if (part?.text) {
    outputDiv.innerHTML += part.text;
  }
}

كل part.text هو جزء من الاستجابة. أضفه إلى واجهة المستخدم الخاصة بك؛ يرى المستخدم النص يظهر كلمة بكلمة.

الخطوة 5: الرؤية (إدخال الصور)

أقوى ميزة في Gemini هي الترسيخ متعدد الوسائط. مرّر عنوان URL لصورة كوسيط ثانٍ:

puter.ai.chat(
  "What do you see in this image? Describe colors, objects, and mood.",
  "https://assets.puter.site/doge.jpeg",
  { model: 'google/gemini-2.5-flash' }
).then(response => {
  puter.print(response);
});

حالات الاستخدام: توليد النص البديل للصور، ضمان الجودة البصري، تحليل لقطات الشاشة، التعرف الضوئي على الحروف (OCR)، أدوات الوصول، وسم صور المنتجات. جودة رؤية Gemini قوية باستمرار في الصور الطبيعية والرسوم البيانية؛ في لقطات الشاشة النصية الكثيفة، يتفوق GPT-5.x عليها أحيانًا.

الخطوة 6: ضبط درجة الحرارة

مرّر المعلمات القياسية في كائن الخيارات:

const response = await puter.ai.chat(
  'Write a creative short story about a robot chef',
  {
    model: 'google/gemini-2.5-flash',
    temperature: 0.2,
  }
);

استخدم درجة حرارة أقل (0.0–0.3) للمخرجات الواقعية أو المنظمة، وأعلى (0.7–1.0) للكتابة الإبداعية. تعمل إعدادات Gemini Flash الافتراضية جيدًا عند درجة حرارة 0.7 لمعظم حالات استخدام الدردشة.

الخطوة 7: المحادثات متعددة الأدوار

مرّر مصفوفة من الرسائل:

const messages = [
  { role: 'user', content: 'I am building a Next.js app with Postgres.' },
  { role: 'assistant', content: 'Got it. What do you need help with?' },
  { role: 'user', content: 'How should I structure migrations?' },
];

const response = await puter.ai.chat(messages, {
  model: 'google/gemini-2.5-pro',
});

console.log(response);

أضف كل رسالة مستخدم وكل استجابة للمساعد إلى المصفوفة قبل الاستدعاء التالي. يقرأ Gemini النص الكامل ويحافظ على الاتساق عبر الأدوار.

مقارنة Gemini بنماذج أخرى على نفس المطالبة

يعرض Puter كل نماذج اللغات الكبيرة الرئيسية عبر واجهة واحدة. أسرع طريقة للعثور على النموذج المناسب لحالة استخدامك هي كتابة نفس المطالبة عبر المزودين المختلفين:

const models = [
  'google/gemini-2.5-flash',
  'claude-sonnet-4-6',
  'gpt-5.5',
  'x-ai/grok-4.3',
];
const prompt = "Refactor this React component to use hooks: ...";

for (const model of models) {
  const start = performance.now();
  const response = await puter.ai.chat(prompt, { model });
  const elapsed = performance.now() - start;
  console.log(`${model}: ${elapsed.toFixed(0)}ms`);
  console.log(response);
  console.log('---');
}

شغّله مرة واحدة وسترى نمط المفاضلة. عادةً ما يكون Gemini Flash هو الفائز من حيث زمن الاستجابة، وسونيت هو الفائز من حيث الجودة في البرمجة، وGPT-5.5 هو الفائز من حيث الجودة في الكتابة الطويلة، وGrok 4.3 يفوز من حيث التكلفة. اختر النموذج الذي يناسب احتياجاتك.

ماذا تحصل عليه وما لا تحصل عليه

التقسيم الصادق:

تحصل على:

كتالوج Gemini 2.5/2.0/3 Flash الكامل بالإضافة إلى 2.5 Pro
عائلة Gemma المفتوحة (2/3/4) لسير العمل مفتوح الوزن
محادثات متعددة الأدوار
استجابات متدفقة
مدخلات الرؤية (عنوان URL للصورة)
درجة الحرارة، max_tokens، مطالبات النظام
قابلية التوسع جاهزة للإنتاج

قد لا تحصل على (حسب إصدار Puter):

استدعاء الدالة الأصلي على Gemini (تحقق من أحدث وثائق Puter)
أداة تنفيذ الأكواد
ترسيخ بحث Google
سياق طويل يصل إلى الحد الأقصى لـ Gemini وهو 2 مليون رمز مميز
الاستخدام من جانب الخادم بدون سياق المتصفح
رؤية مباشرة لحدود المعدل من Google

بالنسبة للتدفقات الوكيلية العميقة التي تتطلب تنفيذ الأكواد والترسيخ، توفر لك واجهة برمجة تطبيقات Google AI Studio الرسمية المزيد. أما بالنسبة للمحادثات النموذجية، والأسئلة والأجوبة، وتوليد المحتوى، والمهام المرئية، فإن Puter يكفي.

متى تستخدم Puter مقابل واجهة برمجة تطبيقات Gemini الرسمية

التقسيم:

استخدم Puter عندما:

تطلق تطبيقًا عامًا مجانيًا ولا ترغب في تحمل مخاطر الفواتير.
تقوم بإنشاء نموذج أولي ولا ترغب في إعداد مشروع Google Cloud.
تريد استخدام Gemini في موقع ثابت، مشروع هاكاثون، أو إضافة متصفح بدون واجهة خلفية.
مستخدموك مستعدون لتسجيل الدخول إلى Puter.

استخدم واجهة برمجة تطبيقات Gemini الرسمية عندما:

تحتاج إلى استدعاءات من جانب الخادم (cron، دفعات، webhooks).
تحتاج إلى تنفيذ الأكواد، ترسيخ البحث، أو Gemini Pro بسياق طويل بحد أقصى 2 مليون رمز مميز.
تحتاج إلى علاقة تعاقدية مع Google للامتثال.
تحتاج إلى ضبط دقيق على مجموعة البيانات الخاصة بك.
مستخدموك لن يتحملوا خطوة تسجيل الدخول إلى Puter.

للاطلاع على شرح مفصل لـ Gemini 3 Flash، راجع كيفية استخدام واجهة برمجة تطبيقات Gemini 3 Flash Preview.

اختبار التكامل في Apidog

تحدث استدعاءات Puter في المتصفح، لذا لا يمكنك برمجتها من أداة تشغيل اختبارات الواجهة الخلفية. النمط الذي يعمل هو:

أنشئ صفحة ثابتة صغيرة باستخدام سكريبت Puter ومعامل استعلام (query parameter) للمطالبة.
استخدم Apidog للتحقق من واجهة برمجة تطبيقات Google Gemini الأصلية (عند الترحيل في النهاية).
احتفظ بهما كبيئتين منفصلتين في نفس مجموعة Apidog حتى تتمكن من التبديل بنقرة واحدة.

قم بـ تنزيل Apidog وقم بإعداد بيئتين: `puter-prototype` (عنوان URL محلي يستضيف صفحة Puter الخاصة بك) و`gemini-prod` (`https://generativelanguage.googleapis.com/v1`). يتم نقل المجموعة بسلاسة عند الانتهاء. لأنماط اختبار API الأوسع، راجع أداة اختبار API لمهندسي ضمان الجودة.

مسارات LLM مجانية أخرى عبر Puter

يعمل نموذج الدفع من قبل المستخدم نفسه مع كل LLM رئيسي:

احصل على واجهة برمجة تطبيقات Claude مجانية وغير محدودة (Anthropic Opus, Sonnet, Haiku)
احصل على واجهة برمجة تطبيقات GPT-5.5 مجانية وغير محدودة (كتالوج OpenAI الكامل)
كيفية استخدام Grok 4.3 مجانًا (xAI)
احصل على واجهة برمجة تطبيقات DeepSeek مجانية وغير محدودة

يتعامل سكريبت Puter الواحد مع كل هذه النماذج. غيّر سلسلة `model` لتغيير المزود.

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

هل هذا غير محدود حقًا، أم يوجد سقف خفي؟غير محدود من جانب المطور، نعم. المستخدم النهائي لديه أي رصيد في حسابه على Puter؛ تحصل الحسابات الجديدة على رصيد بدء، ويقوم المستخدمون بإعادة الشحن إذا أرادوا المزيد.

هل أحتاج إلى حساب Google أو مشروع Google Cloud؟لا. يتولى Puter التعامل مع Google. لن ترى مفتاح Google API أبدًا.

هل يمكنني استخدام هذا في بيئة الإنتاج؟نعم لتطبيقات الويب المستندة إلى المتصفح. يدير Puter بنية تحتية للإنتاج. السؤال الصحيح هو ما إذا كان المستخدمون يتحملون خطوة تسجيل الدخول إلى Puter.

هل يعمل Gemini عبر Puter بنفس طريقة واجهة برمجة التطبيقات الرسمية؟مخرجات النموذج هي نفسها؛ يستدعي Puter واجهة برمجة تطبيقات Google نيابة عن المستخدم. قد يكون زمن الاستجابة أعلى قليلاً بسبب الخطوة الإضافية، لكن سلوك النموذج لا يتغير.

ماذا عن نافذة سياق Gemini الضخمة التي تصل إلى 2 مليون رمز مميز؟لا يكشف Puter عن السقف الكامل لـ 2 مليون رمز مميز في كل متغير من النموذج اليوم. بالنسبة للسياقات الطويلة للغاية، فإن واجهة برمجة تطبيقات Google AI Studio الرسمية هي المسار الصحيح. معظم حالات الاستخدام تبقى أقل بكثير من 200 ألف رمز مميز، حيث يكون Puter مناسبًا.

هل يمكنني استخدام Gemini عبر Puter في بوت Discord أو خدمة خلفية؟ليس بشكل سلس. Puter يعتمد على المتصفح أولاً ويفترض وجود جلسة مستخدم. يجب أن تستخدم الخدمات الخلفية واجهة برمجة تطبيقات Gemini الرسمية مباشرة.

ما هو النموذج الذي يجب أن أستخدمه افتراضيًا؟`google/gemini-2.5-flash`. إنه التوازن الصحيح بين التكلفة والسرعة والجودة لمعظم المطالبات. انتقل إلى `google/gemini-2.5-pro` لمهام التفكير الصعبة، وإلى `google/gemini-2.5-flash-lite` للتصنيف عالي الحجم.

هل يتم دعم توليد الصور (Imagen)؟يكشف Puter عن توليد الصور من خلال `gpt-image-2` ومتغيرات DALL-E من OpenAI اليوم، وليس Imagen. راجع احصل على واجهة برمجة تطبيقات GPT-5.5 مجانية وغير محدودة لمسار توليد الصور.

خاتمة

يُعد Gemini المجاني وغير المحدود عبر Puter.js هو المسار الأسهل لأي تطبيق يستند إلى المتصفح ويرغب في الحصول على مخرجات متعددة الوسائط بجودة Google دون إعداد Google Cloud. قم بإضافة السكريبت، اختر `gemini-2.5-flash`، واكتب المطالبة. يغطي المستخدم النهائي الاستخدام؛ وأنت تنشر بدون مفتاح.

بالنسبة لـ Gemini من جانب الخادم، والضبط الدقيق، وأدوات تنفيذ الأكواد، أو سياق 2 مليون رمز مميز كامل، لا تزال واجهة برمجة تطبيقات Google AI Studio الرسمية هي الإجابة الصحيحة. أما بالنسبة للنماذج الأولية، وبناء الهاكاثونات، والتطبيقات العامة المجانية، والمواقع الثابتة، فإن Puter هو الحل.

قم ببناء الطلب مرة واحدة في Apidog، قارن أداء Puter بواجهة برمجة التطبيقات الرسمية، واختر المسار الذي يناسب احتياجاتك.

زر