OpenAI’ın GPT-5.5'i ücretli bir API ile gelir: Milyon girdi jetonu başına 5 dolar, milyon çıktı başına 30 dolar. Bir yan proje, bir hackathon projesi veya ücretsiz bir genel uygulama için bu fatura, iş başlamadan onu durdurur. Yapısal bir çözüm var: Puter.js, tüm OpenAI kataloğunu (GPT-5.5, GPT-5.5 Pro, her GPT-5.x varyantı, GPT-Image-2, DALL-E, OpenAI TTS) bir OpenAI anahtarı olmadan kullanıma sunar ve sizin yerinize son kullanıcıyı faturalandırır. Geliştirici için yüzey ücretsiz ve sınırsızdır.
Kısaca
- Puter.js, geliştiricilere API anahtarı, OpenAI hesabı veya sunucu gerektirmeden tüm OpenAI model kataloğuna ücretsiz, sınırsız erişim sağlar.
- Desteklenen metin modelleri arasında gpt-5.5, gpt-5.5-pro, gpt-5.4, gpt-5, gpt-5-mini, o1, o3, gpt-4.1, gpt-4o ile birlikte her sohbet ve kodeks varyantı bulunur.
- Görüntü: gpt-image-2, gpt-image-1.5, dall-e-3. Metin Okuma (TTS): gpt-4o-mini-tts, tts-1, tts-1-hd.
- Tek bir
<script>etiketi, tek bir fonksiyon çağrısı (puter.ai.chat) ile GPT-5.5 ile konuşuyorsunuz. - Akış, fonksiyon çağırma, görsel girdi, görüntü oluşturma ve metin okuma hepsi tarayıcıda çalışır.
- Son kullanıcı kullanımını bir Puter hesabından karşılar; siz sıfır ödersiniz, sonsuza dek.
- Taşıma planlaması için aynı komut istemini Puter ve resmi OpenAI API'ye karşı kıyaslamak amacıyla Apidog'u kullanın.
“Ücretsiz sınırsız” nasıl çalışır
Puter.js LLM faturalandırma modelini tersine çevirir. OpenAI anahtarını elinizde tutmak ve 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 bakiye yüklerler.
Geliştirici için üç şey geçerlidir:
- OpenAI hesabı yok, deponuzda anahtar yok. Sızıntı riski yok, döndürme yok, projeye özel anahtar yönetimi yok.
- Sizin tarafınızda kullanım sınırı yok. Her kullanıcı kendi hesabına karşı çalışır, bu nedenle "sınırınız" kullanıcı tabanınızla doğrusal olarak ölçeklenir.
- Faturalandırma riski yok. OpenAI'dan hiçbir zaman Stripe faturası görmezsiniz; kurumsal koşulları müzakere etmenize gerek yoktur.
Dezavantajı: bu öncelikli olarak tarayıcı tabanlıdır. Bir arka uç Node betiği, oturum açmış bir kullanıcı oturumu olmadan Puter'ı kullanamaz. Arka uç kullanımı için resmi OpenAI API hala doğru yoldur.
Adım 1: Kurulum
Tek CDN etiketi, derleme adımı yok:
<script src="https://js.puter.com/v2/"></script>
Tüm kurulum bu. Veya paketlenmiş bir uygulama için:
npm install @heyputer/puter.js
import { puter } from '@heyputer/puter.js';
CDN sürümü herhangi bir HTML dosyasında, hackathon prototipinde, statik sitede veya tarayıcı eklentisinde çalışır. NPM sürümü size ağaç sallama ve TypeScript türleri sunar.
Adım 2: Bir model seçin
Puter, tüm GPT-5.x serisini ve ayrıca tüm eski modelleri kullanıma sunar. Kısa liste:
| Model Kimliği | Ne Zaman Kullanılır |
|---|---|
gpt-5.5-pro |
En derin akıl yürütme; kodlama ajanları, karmaşık analiz |
gpt-5.5 |
Varsayılan günlük sürücü; güçlü maliyet/kalite dengesi |
gpt-5.4-nano |
En ucuz, en hızlı metin; yüksek hacimli sınıflandırma |
gpt-5.4-mini |
Orta seviye; sohbet kullanıcı arayüzleri için iyi |
gpt-5.3-codex |
Koda özel görevler |
o3 |
Karmaşık akıl yürütme zincirleri |
o1-pro |
Ajan tabanlı çok adımlı planlama |
gpt-4.1, gpt-4o, gpt-4o-mini |
Kararlı, iyi anlaşılmış temel |
Görüntü oluşturma:
gpt-image-2: en yeni, keskin çıktı, hızlı.gpt-image-1.5/gpt-image-1/dall-e-3/dall-e-2: eski ama kararlı.
Metin Okuma:
gpt-4o-mini-tts: en yeni, en doğal ses.tts-1,tts-1-hd: klasik Metin Okuma, daha düşük gecikme.
Adım 3: GPT-5.5'i Konuşturun
Minimum geçerli sohbet çağrısı:
<!DOCTYPE html>
<html>
<body>
<script src="https://js.puter.com/v2/"></script>
<script>
puter.ai.chat(
"Explain WebSockets in three sentences",
{ model: "gpt-5.5" }
).then(response => {
puter.print(response);
});
</script>
</body>
</html>
Bir tarayıcıda açın. Puter çağrıyı halleder, 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 Sağlayın
Sohbet kullanıcı arayüzleri ve uzun yanıtlar için akış doğru varsayılandır. stream: true değerini geçirin ve yineleyiciyi tüketin:
const response = await puter.ai.chat(
"Explain the theory of relativity in detail",
{ model: "gpt-5.5", stream: true }
);
for await (const part of response) {
puter.print(part?.text);
}
Her bir part.text bir jeton parçasıdır. UI baloncuğunuza ekleyin; kullanıcı metnin kelime kelime göründüğünü görür.
Adım 5: Görsel (Görüntü girişi)
İkinci argüman olarak bir görüntü URL'si geçirin; model görüntüyü okur ve onunla ilgili komut istemini yanıtlar:
puter.ai.chat(
"What do you see in this image? Describe colors, objects, and mood.",
"https://assets.puter.site/doge.jpeg",
{ model: "gpt-5.5" }
).then(response => {
puter.print(response);
});
Bu, her GPT-5.x modelinde ve GPT-4o varyantlarında çalışır. Kullanım alanları: alt metin oluşturma, görsel kalite güvence, ekran görüntüsü analizi, OCR, erişilebilirlik araçları.
Adım 6: Görüntü Oluşturun
Puter'ın txt2img'si, oluşturulan görüntünün zaten yüklenmiş olduğu bir <img> öğesi döndürür:
puter.ai.txt2img(
"A futuristic cityscape at night, cinematic, neon, rain",
{ model: "gpt-image-2" }
).then(imageElement => {
document.body.appendChild(imageElement);
});
Kullanıcı, görüntü oluşturma maliyetini Puter hesabından öder (genellikle görüntü başına birkaç sent). Ücretsiz bir genel görüntü oluşturucu için bu, günümüzde var olan en temiz kurulumdur.
Adım 7: Metin Okuma
OpenAI'ın Metin Okuma (TTS) serisi txt2speech aracılığıyla kullanıma sunulur. Fonksiyon, oluşturulan sesin bulunduğu bir <audio> öğesi döndürür:
puter.ai.txt2speech(
"Welcome back. Your account balance is $1,247.50.",
{ provider: "openai", model: "gpt-4o-mini-tts" }
).then(audio => {
audio.setAttribute("controls", "");
document.body.appendChild(audio);
});
Sesli komutlar, uygulama seslendirmeleri, podcast girişleri veya erişilebilirlik anlatımları için kullanın.
Adım 8: Fonksiyon Çağırma
Standart OpenAI şekli. Araçları beyan edin, model bir tool_calls dizisi yayar, siz yürütürsünüz, siz yanıtlarsınız:
const tools = [{
type: "function",
function: {
name: "get_weather",
description: "Get the current weather for a city.",
parameters: {
type: "object",
properties: { city: { type: "string" } },
required: ["city"],
},
},
}];
const response = await puter.ai.chat(
"What's the weather in Tokyo right now?",
{ model: "gpt-5.5", tools }
);
const toolCalls = response.message.tool_calls;
if (toolCalls?.length) {
// Execute the function on your side, then reply with the result
console.log(toolCalls[0].function.name, toolCalls[0].function.arguments);
}
Fonksiyon çağırma şekli OpenAI'ınkini yansıtır, bu nedenle bugün sahip olduğunuz tüm araç tanımları doğrudan taşınabilir. Üretim düzeyinde ayarlarda araç odaklı akışları test etmek için Apidog'da MCP sunucu testi makalesine bakın.
Adım 9: Sıcaklığı ve Max_Tokens'ı Ayarlayın
Seçenekler nesnesinde standart OpenAI parametrelerini geçirin:
const response = await puter.ai.chat(
"Tell me about Mars",
{
model: "gpt-5.5",
temperature: 0.2,
max_tokens: 200,
}
);
Gerçekçi yanıtlar için daha düşük sıcaklık (0.0–0.3), yaratıcı yazım için daha yüksek (0.7–1.0) kullanın. max_tokens kullanıcı tarafındaki maliyeti sınırlar; genel bir uygulama yayınladığınızda çağrı başına ücretleri tahmin edilebilir tutmak için faydalıdır.
Ne Aldığınız ve Ne Almadığınız
Puter'ın ücretsiz sınırsız GPT-5.5 erişimi gerçektir, ancak resmi OpenAI API yüzeyinin bir alt kümesidir. Dürüst ayrım:
Şunları alırsınız:
- 5.5, 5.5 Pro, 5.4 (mini, nano, pro) ve her kodeks varyantı dahil olmak üzere tam GPT-5.x kataloğu
- Tüm eski OpenAI modelleri (GPT-4.1, GPT-4o, o1, o3)
- Ücretsiz görüntü oluşturma için GPT-Image-2 ve DALL-E
- gpt-4o-mini-tts dahil OpenAI TTS serisi
- Akış, görsel, fonksiyon çağırma, sıcaklık kontrolü, max_tokens
Şunları alamayabilirsiniz:
- Yanıtlar API'si (Puter, Sohbet Tamamlamaları şeklini kullanır)
- Komut istemi önbellekleme maliyet azaltımı
- Dosyalar API'si (yüklenen belge bağlamı)
- Tarayıcı bağlamı olmadan sunucu tarafı kullanım
- OpenAI'dan doğrudan hız sınırı başlıkları
- OpenAI'ın yapılandırılmış çıktı modu ve JSON şema zorlaması
Derin üretim düzeyinde akışlar için resmi OpenAI API doğru yanıttır. Tarayıcı uygulamaları, yan projeler ve genel araçlar için Puter yeterlidir.
Puter mı yoksa resmi OpenAI mı kullanılmalı
Ayrım:
Puter'ı şu durumlarda kullanın:
- Ücretsiz bir genel uygulama yayınlıyor ve faturalandırma riski istemiyorsanız.
- Prototipleme yapıyor ve bir OpenAI faturalandırma ilişkisi kurmak istemiyorsanız.
- Arka uç olmadan statik bir sitede, hackathon projesinde veya tarayıcı eklentisinde OpenAI erişimi istiyorsanız.
- Kullanıcılarınız Puter'a giriş yapmaktan memnunsa (veya zaten kullanıyorlarsa).
Resmi OpenAI API'sini şu durumlarda kullanın:
- Sunucu tarafı çağrılara ihtiyacınız varsa (cron işleri, webhook işleyicileri, toplu işleme).
- Kararlı sistem istemlerinde maliyet tasarrufu için istem önbelleklemesine ihtiyacınız varsa.
- Yanıtlar API'sine, Dosyalara veya tam yapılandırılmış çıktılara ihtiyacınız varsa.
- Uyumluluk için sözleşmeye dayalı bir ilişkiye ihtiyacınız varsa (BAA'lar, SOC 2, ikamet).
- Kullanıcılarınız bir Puter giriş adımına tolerans göstermeyecekse.
Çoğu proje prototipleme için Puter ile başlar ve yukarıdaki sınırlardan birine ulaştıklarında resmi API'ye geçiş yapar. Geçiş basittir; mesaj şekli aynıdır.
Ücretli üretim kurulumu için GPT-5.5 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 onları doğrudan bir arka uç test çalıştırıcısından betikleyemezsiniz. Çalışan desen:
- Puter betiği ve komut istemi için bir sorgu parametresi içeren küçük bir statik sayfa oluşturun.
- Yukarı akış OpenAI API yüzeyini doğrulamak için Apidog'u kullanın (nihayetinde geçiş yaptığınızda).
- Tek bir tıklamayla 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 openai-prod (https://api.openai.com/v1). Mezun olduğunuzda koleksiyon sorunsuz bir şekilde taşınır. Daha geniş API test desenleri için QA mühendisleri için API test aracı makalesine bakın.
Sıkça Sorulan Sorular
Bu gerçekten sınırsız mı, yoksa gizli bir sınır var mı?Geliştirici tarafı için sınırsız, evet. Son kullanıcı, Puter hesaplarındaki bakiyeyi kullanır; yeni hesaplar başlangıç kredisi alır ve kullanıcılar daha fazlasını isterlerse bakiye yüklerler. Geliştirici başına bir sınır yoktur.
Bir OpenAI hesabına ihtiyacım var mı?Hayır. Puter, OpenAI ilişkisini yönetir. Bir OpenAI anahtarı asla görmezsiniz.
Bunu üretimde kullanabilir miyim?Evet, tarayıcı tabanlı uygulamalar için. Puter üretim altyapısını çalıştırır. Asıl soru, kullanıcılarınızın Puter'a giriş yapmaya istekli olup olmadığıdır; eğer öyleyse, yayınlayın.
Puter aracılığıyla GPT-5.5, resmi API ile aynı performansı gösterir mi?Model çıktısı aynıdır; Puter, kullanıcının adına resmi OpenAI API'sini çağırır. Ek bir atlama nedeniyle gecikme marjinal olarak daha yüksek olabilir, ancak model davranışı değişmez.
Komut istemi önbellekleme tasarrufları ne olacak?Puter, şu anda OpenAI'ın komut istemi önbellekleme fiyatlandırma kontrollerini sunmaz. Eğer kararlı bir 50 bin jetonluk sistem komut isteminiz varsa ve önbellek indirimine ihtiyacınız varsa, resmi API'yi kullanın.
Bunu bir arka uç hizmetinde kullanabilir miyim?Temiz bir şekilde kullanılamaz. Puter öncelikli olarak tarayıcı tabanlıdır ve bir kullanıcı oturumu varsayar. Arka uç hizmetleri resmi OpenAI API'sini kullanmalıdır. Ücretsiz sunucu tarafı seçenekler için GPT-5.5 API'si Ücretsiz Nasıl Kullanılır makalesine bakın.
Hangi modeli varsayılan olarak kullanmalıyım?Günlük akıl yürütme için gpt-5.5. Yüksek hacimli sınıflandırma için gpt-5.4-nano. Zor akıl yürütme görevleri için gpt-5.5-pro. Uzun akıl yürütme zincirlerine ihtiyacınız olduğunda o3.
Kullanıcılarım çok mu ücretlendirilecek?Çoğu sohbet tarzı kullanım, OpenAI oranlarına göre oturum başına sentlere mal olur. Sıradan bir kullanıcı, Puter'ın başlangıç kredisiyle bakiye yüklemeden önce onlarca konuşma yapabilir. Görüntü oluşturma daha pahalıdır; max_tokens değerini sınırlayın ve boşa giden oluşturma çağrılarından kaçının.
Puter ile ücretsiz görüntü oluşturabilir miyim?Evet, gpt-image-2 veya DALL-E ile txt2img aracılığıyla. Kullanıcı, görüntü oluşturma maliyetini Puter bakiyesinden öder. Resmi ücretli API kılavuzu için GPT-Image-2 API'si Nasıl Kullanılır makalesine bakın.
Özetle
Puter.js aracılığıyla ücretsiz sınırsız GPT-5.5, OpenAI kalitesinde çıktı isteyen ancak OpenAI kalitesinde faturalandırma istemeyen herhangi bir tarayıcı tabanlı uygulama için en temiz yoldur. Betiği ekleyin, bir model seçin, komut istemini yazın. Son kullanıcı kullanımı karşılar; siz anahtar olmadan yayınlarsınız.
Sunucu tarafı iş yükleri, komut istemi önbellekleme, Yanıtlar API'si veya tam yapılandırılmış çıktılar için resmi OpenAI API hala doğru yanıttır. Prototiplemeler, hackathon projeleri, ücretsiz genel uygulamalar ve statik siteler için Puter cevaptır.
İsteği Apidog'da bir kez oluşturun, Puter'ı resmi API'ye karşı kıyaslayın ve şeklinize uygun yolu seçin.
