Google'ın Gemini ailesi, yüksek hacimli iş yükleri için en uygun maliyetli sınır modeli serisidir; Gemini 2.5 Pro, milyon jeton başına 1,25 / 10 dolar maliyetle çalışır ve Flash varyantları çok daha ucuzdur. Ücretsiz bir genel uygulama, bir yan proje veya bir hackathon geliştirme için, birkaç bin kullanıcı uç noktanıza ulaştığında bile bu oranlar hızla artar. Puter.js modeli tersine çevirir: tüm Gemini serisini (2.5 Pro, 2.5 Flash, 2.0 Flash, 3 Flash önizlemesi, artı açık Gemma 2/3/4 ailesi) bir Google API anahtarı olmadan sunar ve faturalandırmayı sizin yerinize son kullanıcıya yapar. Geliştirici için yüzey ücretsiz ve sınırsızdır.
TL;DR
- Puter.js geliştiricilere tam Gemini ve Gemma kataloğuna Google API anahtarı, Google Cloud projesi ve sunucu olmadan ücretsiz, sınırsız erişim sağlar.
- Desteklenen Gemini: 2.5 Pro, 2.5 Flash, 2.5 Flash Lite, 2.0 Flash, 2.0 Flash Lite, 3 Flash Önizlemesi, ayrıca eski önizlemeler.
- Desteklenen Gemma: Birden çok boyutta (4B, 12B, 27B, 31B, 26B-A4B) Gemma 2, 3, 4.
- Tek bir
<script>etiketi, tek bir fonksiyon çağrısı ile Gemini ile konuşmaya başlarsınız. - Akış, görüntü girişi, sıcaklık kontrolü hepsi tarayıcıda çalışır.
- Son kullanıcı, Puter hesabından kendi kullanımını karşılar; siz sıfır ödersiniz, sonsuza kadar.
- Geçiş planlaması için Puter'ı resmi Gemini API'si ile karşılaştırmak için Apidog kullanın.
“Ücretsiz sınırsız” nasıl çalışır
Puter.js, LLM faturalandırma modelini tersine çevirir. Google AI Studio anahtarını tutup her jeton maliyetini karşılamak yerine, son kullanıcınız Puter'a (ücretsiz hesap) giriş yapar ve çağrı onların bakiyesinden ücretlendirilir. Yeni Puter hesapları başlangıç kredisi alır; kullanıcılar daha fazlasını isterlerse yükleme yaparlar.
Geliştirici için sonuçlar nettir:
- Google Cloud projesi yok, AI Studio anahtarı yok. Kota pazarlığı yok, anahtar rotasyonu yok, faturalandırma ilişkisi yok.
- Sizin tarafınızda kullanım limiti yok. "Limitiniz" kullanıcı tabanınızla doğrusal olarak ölçeklenir.
- Google faturalandırmasına satıcı bağımlılığı yok. Puter, yukarı akış çağrısını yönetir.
Takas: bu tarayıcı önceliklidir. Bir arka uç zamanlanmış görevi, oturum açmış bir kullanıcı oturumu olmadan Puter'ı kullanamaz.
Adım 1: Yükle
Tek bir CDN etiketi, derleme adımı yok:
<script src="https://js.puter.com/v2/"></script>
Tüm kurulum budur. Veya paketlenmiş bir uygulama için:
npm install @heyputer/puter.js
import { puter } from '@heyputer/puter.js';
Adım 2: Bir model seçin
Puter'daki Gemini serisi, her şekil için doğru araçla birlikte:
| Model Kimliği | Ne zaman kullanılır |
|---|---|
google/gemini-2.5-pro |
En derin akıl yürütme; karmaşık analiz ve uzun bağlam görevleri |
google/gemini-2.5-flash |
Varsayılan günlük sürücü; güçlü maliyet/kalite dengesi |
google/gemini-2.5-flash-lite |
En ucuz Flash varyantı; yüksek hacimli sınıflandırma |
google/gemini-2.0-flash |
Stabil temel; iyi bilinen davranış |
google/gemini-3-flash-preview |
En son önizleme; en son hız |
google/gemma-3-27b-it |
Açık Gemma; talimat odaklı, ince ayar temelleri için iyi |
google/gemma-4-31b-it |
En büyük açık Gemma; kapalı-Gemini kalitesine daha yakın |
Çoğu uygulama için, varsayılan olarak gemini-2.5-flash kullanın ve Pro'ya yalnızca zorlu istemlerde başvurun. Lite varyantları bir kat daha hızlıdır ve etiketleme, sınıflandırma ve basit Soru-Cevap için yeterince iyidir.
Adım 3: Gemini'yi konuşturun
Minimum geçerli çağrı:
<!DOCTYPE html>
<html>
<body>
<script src="https://js.puter.com/v2/"></script>
<script>
puter.ai.chat(
"Makine öğrenmesini üç cümlede açıklayın",
{ model: 'google/gemini-2.5-flash' }
).then(response => {
puter.print(response);
});
</script>
</body>
</html>
Bir tarayıcıda açın. Puter çağrıyı yönetir, kullanıcı giriş yapar (veya ilk çalıştırmada ücretsiz bir Puter hesabı oluşturur) ve yanıt sayfaya yazdırılır. API anahtarı yok, ortam değişkeni yok, sunucu yok.
Adım 4: Yanıtı akışla alın
Sohbet kullanıcı arayüzleri ve uzun yanıtlar için, akış varsayılan olarak doğru seçimdir:
const response = await puter.ai.chat(
"Fotosentezi ayrıntılı olarak açıklayın",
{
model: 'google/gemini-2.5-flash',
stream: true,
}
);
for await (const part of response) {
if (part?.text) {
outputDiv.innerHTML += part.text;
}
}
Her part.text, yanıtın bir parçasıdır. Kullanıcı arayüzünüze ekleyin; kullanıcı metnin kelime kelime göründüğünü görür.
Adım 5: Vizyon (görüntü girişi)
Gemini'nin en güçlü özelliği çok modlu topraklamadır. İkinci argüman olarak bir görüntü URL'si geçirin:
puter.ai.chat(
"Bu resimde ne görüyorsunuz? Renkleri, nesneleri ve ruh halini açıklayın.",
"https://assets.puter.site/doge.jpeg",
{ model: 'google/gemini-2.5-flash' }
).then(response => {
puter.print(response);
});
Kullanım durumları: alt metin oluşturma, görsel Soru-Cevap, ekran görüntüsü analizi, OCR, erişilebilirlik araçları, ürün görseli etiketleme. Gemini'nin vizyon kalitesi doğal görüntülerde ve diyagramlarda sürekli olarak güçlüdür; yoğun metin ekran görüntülerinde GPT-5.x bazen onu geride bırakır.
Adım 6: Sıcaklığı ayarlayın
Seçenekler nesnesinde standart parametreleri geçirin:
const response = await puter.ai.chat(
'Robot bir şef hakkında yaratıcı bir kısa hikaye yaz',
{
model: 'google/gemini-2.5-flash',
temperature: 0.2,
}
);
Gerçek veya yapılandırılmış çıktı için düşük sıcaklık (0.0–0.3), yaratıcı yazım için yüksek (0.7–1.0). Gemini Flash varsayılanları çoğu sohbet kullanım durumu için 0.7 sıcaklıkta iyi çalışır.
Adım 7: Çok turlu sohbetler
Bir mesaj dizisi geçirin:
const messages = [
{ role: 'user', content: 'Next.js uygulaması ve Postgres kullanıyorum.' },
{ role: 'assistant', content: 'Anladım. Ne konuda yardıma ihtiyacın var?' },
{ role: 'user', content: 'Migrationları nasıl yapılandırmalıyım?' },
];
const response = await puter.ai.chat(messages, {
model: 'google/gemini-2.5-pro',
});
console.log(response);
Bir sonraki çağrıdan önce her kullanıcı mesajını ve her asistan yanıtını diziye ekleyin. Gemini tüm transkripti okur ve turlar arasında tutarlı kalır.
Gemini'yi aynı istemde diğer modellerle karşılaştırma
Puter, her büyük LLM'yi tek bir arayüz aracılığıyla kullanıma sunar. Kullanım durumunuz için doğru modeli bulmanın en hızlı yolu, aynı istemi sağlayıcılar arasında betiklemektir:
const models = [
'google/gemini-2.5-flash',
'claude-sonnet-4-6',
'gpt-5.5',
'x-ai/grok-4.3',
];
const prompt = "Bu React bileşenini kancalar kullanacak şekilde yeniden düzenle: ...";
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('---');
}
Bir kez çalıştırın ve denge modelini görürsünüz. Gemini Flash genellikle gecikme galibi, Sonnet kodlamada kalite galibi, GPT-5.5 uzun biçimli yazımda kalite galibi, Grok 4.3 maliyette kazanır. Şeklinize uygun modeli seçin.
Ne alırsınız ve ne almazsınız
Dürüst ayrım:
Aldıklarınız:
- Tam Gemini 2.5/2.0/3 Flash kataloğu artı 2.5 Pro
- Açık ağırlıklı iş akışları için Açık Gemma ailesi (2/3/4)
- Çok turlu sohbetler
- Akış yanıtları
- Görüntü girişi (resim URL'si)
- Sıcaklık, max_tokens, sistem istemleri
- Üretim hazır ölçeği
Alamayabilecekleriniz (Puter sürümüne bağlı olarak):
- Gemini'de yerel işlev çağrısı (en son Puter belgelerini kontrol edin)
- Kod yürütme aracı
- Google Arama topraklaması
- Gemini'nin tam 2M jeton tavanına kadar uzun bağlam
- Tarayıcı bağlamı olmadan sunucu tarafı kullanım
- Google'dan doğrudan hız sınırı görünürlüğü
Kod yürütme ve topraklama gerektiren derin ajanik akışlar için, resmi Google AI Studio API'si size daha fazlasını sunar. Tipik sohbet, Soru-Cevap, içerik oluşturma ve görsel görevler için Puter yeterlidir.
Puter'ı resmi Gemini API'sine karşı ne zaman kullanmalısınız?
Ayrım:
Puter'ı şu durumlarda kullanın:
- Ücretsiz bir genel uygulama yayınlıyorsunuz ve faturalandırma riski istemiyorsunuz.
- Prototip oluşturuyorsunuz ve bir Google Cloud projesi kurmak istemiyorsunuz.
- Arka uç olmadan statik bir sitede, hackathon projesinde veya tarayıcı uzantısında Gemini'yi istiyorsunuz.
- Kullanıcılarınız Puter'a giriş yapmaktan memnuniyet duyuyor.
Resmi Gemini API'sini şu durumlarda kullanın:
- Sunucu tarafı çağrılara ihtiyacınız var (zamanlanmış görev, toplu işlem, web kancaları).
- Kod yürütme, Arama topraklaması veya tam 2M tavanında uzun bağlamlı Gemini Pro'ya ihtiyacınız var.
- Uyumluluk için Google ile sözleşmeli bir ilişkiye ihtiyacınız var.
- Kendi veri kümeniz üzerinde ince ayar yapmaya ihtiyacınız var.
- Kullanıcılarınız bir Puter giriş adımına tahammül edemiyor.
Bağımsız Gemini 3 Flash kılavuzu için Gemini 3 Flash Önizleme API'si nasıl kullanılır makalesine bakın.
Apidog'da entegrasyonu test etme
Puter çağrıları tarayıcıda gerçekleşir, bu nedenle bunları bir arka uç test çalıştırıcısından betikleyemezsiniz. Çalışan model:
- Puter betiği ve istem için bir sorgu parametresi içeren küçük bir statik sayfa oluşturun.
- (Sonunda geçiş yaptığınızda) yukarı akış Google Gemini API yüzeyini doğrulamak için Apidog kullanın.
- Tek bir tıklama ile değiştirebilmek için her ikisini de aynı Apidog koleksiyonunda ayrı ortamlar olarak tutun.
Apidog'u indirin ve iki ortam kurun: puter-prototype (Puter sayfanızı barındıran bir localhost URL'si) ve gemini-prod (https://generativelanguage.googleapis.com/v1). Gelişme kaydettiğinizde koleksiyon temiz bir şekilde taşınır. Daha geniş API test modelleri için QA mühendisleri için API test aracı makalesine bakın.
Puter aracılığıyla diğer ücretsiz LLM yolları
Aynı kullanıcı ödeme modeli her büyük LLM için çalışır:
- Ücretsiz sınırsız Claude API edinin (Anthropic Opus, Sonnet, Haiku)
- Ücretsiz sınırsız GPT-5.5 API edinin (tam OpenAI kataloğu)
- Grok 4.3 nasıl ücretsiz kullanılır (xAI)
- Ücretsiz sınırsız DeepSeek API edinin
Tek Puter betiği hepsini yönetir. model dizesini değiştirin ve sağlayıcıları değiştirirsiniz.
SSS
Bu gerçekten sınırsız mı, yoksa gizli bir sınır mı var?Geliştirici tarafında sınırsız, evet. Son kullanıcının Puter hesabında ne kadar bakiye varsa o kadar; yeni hesaplar başlangıç kredisi alır ve kullanıcılar daha fazlasını isterlerse yükleme yaparlar.
Bir Google hesabına veya Google Cloud projesine ihtiyacım var mı?Hayır. Puter, Google ilişkisini yönetir. Asla bir Google API anahtarı görmezsiniz.
Bunu üretimde kullanabilir miyim?Tarayıcı tabanlı uygulamalar için evet. Puter üretim altyapısını çalıştırır. Doğru soru, kullanıcılarınızın bir Puter giriş adımına tahammül edip edemeyeceğidir.
Puter aracılığıyla Gemini, resmi API ile aynı performansı sergiliyor mu?Model çıktısı aynıdır; Puter, kullanıcının adına Google'ın API'sini çağırır. Ek bir atlama nedeniyle gecikme biraz daha yüksek olabilir, ancak model davranışı değişmez.
Gemini'nin devasa 2M jetonluk bağlam penceresi ne olacak?Puter, bugün her model varyantında tam 2M tavanı sunmuyor. Son derece uzun bağlam için, resmi Google AI Studio API'si doğru yoldur. Çoğu kullanım durumu 200K jetonun altında kalır, bu durumda Puter iyidir.
Puter aracılığıyla Gemini'yi bir Discord botunda veya arka uç hizmetinde kullanabilir miyim?Temiz bir şekilde hayır. Puter tarayıcı önceliklidir ve bir kullanıcı oturumu varsayar. Arka uç hizmetleri doğrudan resmi Gemini API'sini kullanmalıdır.
Varsayılan olarak hangi modeli kullanmalıyım?google/gemini-2.5-flash. Çoğu istem için maliyet, hız ve kalitenin doğru dengesidir. Zorlu akıl yürütme görevleri için google/gemini-2.5-pro'ya, yüksek hacimli sınıflandırma için ise google/gemini-2.5-flash-lite'a geçin.
Görüntü oluşturma destekleniyor mu (Imagen)?Puter, bugün görüntü oluşturmayı Imagen aracılığıyla değil, OpenAI'nin gpt-image-2 ve DALL-E varyantları aracılığıyla sunar. Görüntü oluşturma yolu için Ücretsiz sınırsız GPT-5.5 API edinin makalesine bakın.
Sonuç
Puter.js aracılığıyla ücretsiz sınırsız Gemini, Google Cloud kurulumu olmadan Google kalitesinde çok modlu çıktı isteyen tüm tarayıcı tabanlı uygulamalar için en temiz yoldur. Betiği bırakın, gemini-2.5-flash'ı seçin, istemi yazın. Son kullanıcı kullanımı karşılar; siz anahtar olmadan yayınlarsınız.
Sunucu tarafı Gemini, ince ayar, kod yürütme araçları veya tam 2M jeton bağlam için, resmi Google AI Studio API'si hala doğru yanıttır. Prototiplemeler, hackathon geliştirmeleri, ücretsiz genel uygulamalar ve statik siteler için Puter cevaptır.
Apidog'da isteği bir kez oluşturun, Puter'ı resmi API ile karşılaştırın ve şeklinize uyan yolu seçin.
