DEV Community

Cover image for Ücretsiz Sınırsız GPT-5.5 API ve Tüm OpenAI Modelleri
Tobias Hoffmann
Tobias Hoffmann

Posted on • Originally published at apidog.com

Ücretsiz Sınırsız GPT-5.5 API ve Tüm OpenAI Modelleri

OpenAI’ın GPT-5.5 API maliyeti, küçük projelerde hızlıca engel olabilir: milyon girdi jetonu başına 5 dolar, milyon çıktı jetonu başına 30 dolar. Yan proje, hackathon prototipi veya ücretsiz genel uygulama geliştiriyorsanız Puter.js ile OpenAI kataloğunu OpenAI anahtarı olmadan tarayıcıdan kullanabilir, kullanım maliyetini son kullanıcının Puter hesabına bırakabilirsiniz.

Apidog'u bugün deneyin

Kısaca

  • Puter.js, geliştiricilere API anahtarı, OpenAI hesabı veya sunucu gerektirmeden OpenAI model kataloğuna 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 ve sohbet/kodeks varyantları bulunur.
  • Görüntü modelleri: gpt-image-2, gpt-image-1.5, dall-e-3.
  • Metin okuma modelleri: gpt-4o-mini-tts, tts-1, tts-1-hd.
  • Tek bir <script> etiketi ve puter.ai.chat() çağrısı ile tarayıcıdan GPT-5.5 kullanabilirsiniz.
  • Akış, fonksiyon çağırma, görsel girdi, görüntü oluşturma ve metin okuma tarayıcı tarafında çalışır.
  • Son kullanıcı kullanımı kendi Puter hesabından karşılar; geliştirici OpenAI anahtarı veya fatura yönetmez.
  • Taşıma planı yaparken aynı prompt’u Puter ve resmi OpenAI API üzerinde kıyaslamak için Apidog kullanabilirsiniz.

“Ücretsiz sınırsız” model nasıl çalışır?

Puter.js LLM faturalandırma modelini geliştirici tarafının dışına taşır. OpenAI anahtarını uygulamanızda tutmak ve tüm token maliyetlerini sizin karşılamanız yerine, kullanıcı Puter’a giriş yapar ve çağrılar kullanıcının Puter bakiyesinden ücretlendirilir.

Geliştirici açısından sonuç:

  • OpenAI anahtarı yok: Depoda secret tutmazsınız, anahtar sızıntısı veya rotasyon yönetmezsiniz.
  • Kullanım geliştirici hesabınıza yazılmaz: Her kullanıcı kendi Puter hesabıyla çalışır.
  • Faturalandırma riski azalır: OpenAI tarafında Stripe faturası veya kurumsal sözleşme yönetmeniz gerekmez.

Sınır: Bu yaklaşım öncelikle tarayıcı tabanlı uygulamalar içindir. Oturum açmış kullanıcı bağlamı olmadan çalışan Node.js backend scriptleri için resmi OpenAI API hâlâ daha doğru seçenektir.

Adım 1: Puter.js’i projeye ekleyin

Statik HTML, demo, hackathon prototipi veya tarayıcı eklentisi için tek CDN etiketi yeterlidir:

<script src="https://js.puter.com/v2/"></script>
Enter fullscreen mode Exit fullscreen mode

Paketlenmiş uygulamalarda NPM paketini kullanabilirsiniz:

npm install @heyputer/puter.js
Enter fullscreen mode Exit fullscreen mode 
import { puter } from '@heyputer/puter.js';
Enter fullscreen mode Exit fullscreen mode

CDN sürümü hızlı prototipleme için uygundur. NPM sürümü ise modüler kullanım, paketleme ve TypeScript tabanlı projeler için daha kullanışlıdır.

Adım 2: Kullanacağınız modeli seçin

Puter üzerinden GPT-5.x serisi ve eski OpenAI modelleri kullanılabilir. Pratik seçim tablosu:

Model Kimliği Ne zaman kullanılır?
gpt-5.5-pro Derin akıl yürütme, kodlama ajanları, karmaşık analiz
gpt-5.5 Genel amaçlı varsayılan model
gpt-5.4-nano Hızlı ve düşük maliyetli sınıflandırma işleri
gpt-5.4-mini Sohbet arayüzleri ve orta seviye görevler
gpt-5.3-codex Kod odaklı görevler
o3 Karmaşık akıl yürütme zincirleri
o1-pro Çok adımlı ajan planlama
gpt-4.1, gpt-4o, gpt-4o-mini Kararlı ve yaygın kullanılan temel modeller

Görüntü oluşturma için:

  • gpt-image-2: en yeni görüntü modeli.
  • gpt-image-1.5, gpt-image-1, dall-e-3, dall-e-2: eski ama kararlı seçenekler.

Metin okuma için:

  • gpt-4o-mini-tts: daha doğal ses çıktısı.
  • tts-1, tts-1-hd: klasik TTS modelleri.

Adım 3: GPT-5.5 ile ilk sohbet çağrısını yapın

Minimum çalışan örnek:

<!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>
Enter fullscreen mode Exit fullscreen mode

Dosyayı tarayıcıda açın. Puter kullanıcı oturumunu yönetir, çağrıyı yapar ve yanıtı sayfaya yazar. OpenAI API anahtarı, .env dosyası veya backend gerekmez.

Adım 4: Yanıtı stream edin

Sohbet arayüzlerinde uzun cevabı tek parça bekletmek yerine stream etmek daha iyi kullanıcı deneyimi sağlar.

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);
}
Enter fullscreen mode Exit fullscreen mode

UI tarafında part.text değerini mevcut mesaj balonuna ekleyebilirsiniz:

const bubble = document.querySelector("#assistant-message");

for await (const part of response) {
  if (part?.text) {
    bubble.textContent += part.text;
  }
}
Enter fullscreen mode Exit fullscreen mode

Adım 5: Görsel girdisi kullanın

İkinci argüman olarak bir görüntü URL’si vererek modele görsel analiz yaptırabilirsiniz:

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);
});
Enter fullscreen mode Exit fullscreen mode

Kullanım alanları:

  • Alt text üretimi
  • Ekran görüntüsü analizi
  • Görsel kalite kontrolü
  • OCR benzeri çıkarımlar
  • Erişilebilirlik araçları

Adım 6: Görüntü oluşturun

puter.ai.txt2img() oluşturulan görseli yüklenmiş bir <img> elementi olarak 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);
});
Enter fullscreen mode Exit fullscreen mode

Basit bir form ile prompt’u kullanıcıdan alabilirsiniz:

<input id="prompt" placeholder="Görsel açıklaması yazın" />
<button id="generate">Oluştur</button>
<div id="result"></div>

<script src="https://js.puter.com/v2/"></script>
<script>
  document.querySelector("#generate").addEventListener("click", async () => {
    const prompt = document.querySelector("#prompt").value;

    const image = await puter.ai.txt2img(prompt, {
      model: "gpt-image-2",
    });

    document.querySelector("#result").innerHTML = "";
    document.querySelector("#result").appendChild(image);
  });
</script>
Enter fullscreen mode Exit fullscreen mode

Adım 7: Metin okuma ekleyin

OpenAI TTS modelleri txt2speech() ile kullanılabilir. Fonksiyon, oluşturulan sesi içeren bir <audio> elementi 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);
});
Enter fullscreen mode Exit fullscreen mode

Bunu şu alanlarda kullanabilirsiniz:

  • Uygulama içi sesli bildirimler
  • Erişilebilirlik anlatımları
  • Podcast girişleri
  • Sesli asistan prototipleri

Adım 8: Fonksiyon çağırma kullanın

Puter fonksiyon çağırma tarafında OpenAI benzeri araç tanımı şeklini kullanır. Önce araçları tanımlayın:

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"],
    },
  },
}];
Enter fullscreen mode Exit fullscreen mode

Ardından modeli çağırın:

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) {
  console.log(
    toolCalls[0].function.name,
    toolCalls[0].function.arguments
  );
}
Enter fullscreen mode Exit fullscreen mode

Üretimde burada şu akışı kurarsınız:

  1. Modelin istediği fonksiyonu okuyun.
  2. Fonksiyonu kendi tarafınızda çalıştırın.
  3. Sonucu modele geri verin.
  4. Kullanıcıya doğal dilde yanıt üretin.

Fonksiyon çağırma şekli OpenAI tarafına benzediği için mevcut araç tanımlarınızı taşımak daha kolaydır. Araç odaklı akışları test etmek için Apidog’da MCP sunucu testi makalesine de bakabilirsiniz.

Adım 9: temperature ve max_tokens ayarlayın

Standart OpenAI parametrelerini seçenekler nesnesinde geçebilirsiniz:

const response = await puter.ai.chat(
  "Tell me about Mars",
  {
    model: "gpt-5.5",
    temperature: 0.2,
    max_tokens: 200,
  }
);
Enter fullscreen mode Exit fullscreen mode

Pratik ayarlar:

  • Gerçekçi ve tutarlı yanıtlar: temperature: 0.0 – 0.3
  • Daha yaratıcı yanıtlar: temperature: 0.7 – 1.0
  • Maliyet ve çıktı uzunluğu kontrolü: max_tokens

Genel kullanıma açık uygulamalarda max_tokens belirlemek önemlidir. Kullanıcının yanlışlıkla çok uzun ve maliyetli yanıtlar üretmesini sınırlar.

Ne alırsınız, ne alamayabilirsiniz?

Puter.js ile OpenAI modellerine erişim pratik ve hızlıdır; ancak resmi OpenAI API yüzeyinin birebir tamamı değildir.

Alabilecekleriniz:

  • GPT-5.x kataloğu: 5.5, 5.5 Pro, 5.4 mini/nano/pro ve kodeks varyantları
  • Eski OpenAI modelleri: GPT-4.1, GPT-4o, o1, o3
  • GPT-Image-2 ve DALL-E ile görüntü oluşturma
  • gpt-4o-mini-tts dahil OpenAI TTS modelleri
  • Streaming
  • Görsel girdi
  • Fonksiyon çağırma
  • temperature ve max_tokens kontrolü

Alamayabilecekleriniz:

  • Responses API
  • Prompt caching maliyet avantajları
  • Files API ile yüklenen belge bağlamı
  • Tarayıcı bağlamı olmadan sunucu tarafı kullanım
  • OpenAI’dan doğrudan rate limit header’ları
  • OpenAI structured outputs ve JSON schema zorlaması

Derin üretim iş yükleri için resmi OpenAI API daha uygun olabilir. Tarayıcı uygulamaları, yan projeler, ücretsiz genel araçlar ve statik siteler için Puter daha hızlı bir başlangıç sağlar.

Puter mı, resmi OpenAI API mi?

Puter’ı şu durumlarda kullanın:

  • Ücretsiz bir genel uygulama yayınlıyorsanız.
  • OpenAI faturalandırması kurmadan prototip geliştirmek istiyorsanız.
  • Backend olmadan statik sitede, hackathon projesinde veya tarayıcı eklentisinde OpenAI erişimi istiyorsanız.
  • Kullanıcılarınız Puter’a giriş yapmayı kabul ediyorsa.

Resmi OpenAI API’sini şu durumlarda kullanın:

  • Sunucu tarafı çağrılara ihtiyacınız varsa.
  • Cron job, webhook handler veya batch processing çalıştırıyorsanız.
  • Prompt caching ile maliyet optimizasyonu istiyorsanız.
  • Responses API, Files API veya structured outputs gerekiyorsa.
  • Uyumluluk, sözleşme veya kurumsal gereksinimleriniz varsa.
  • Kullanıcılarınıza ek Puter giriş adımı göstermek istemiyorsanız.

Çoğu proje için uygulanabilir yol şudur:

  1. Prototipi Puter ile oluşturun.
  2. Prompt ve UI akışını doğrulayın.
  3. Backend veya kurumsal ihtiyaç oluşursa resmi OpenAI API’ye geçin.
  4. Mesaj ve araç tanımlarını mümkün olduğunca aynı tutun.

Ücretli üretim kurulumu için GPT-5.5 API’si Nasıl Kullanılır makalesine bakabilirsiniz.

Apidog’da entegrasyonu test etme

Puter çağrıları tarayıcıda gerçekleştiği için bunları doğrudan backend API test çalıştırıcısından çağırmak ideal değildir. Daha uygulanabilir desen:

  1. Puter scriptini içeren küçük bir statik test sayfası oluşturun.
  2. Prompt’u query parametre veya input alanından alın.
  3. Aynı prompt’u resmi OpenAI API’ye karşı Apidog koleksiyonunda test edin.
  4. Puter prototipi ve OpenAI üretim ortamını ayrı environment olarak saklayın.

Apidog ekran görüntüsü

Apidog’u indirin ve iki environment oluşturun:

  • puter-prototype: Puter sayfanızı barındıran localhost veya statik URL
  • openai-prod: https://api.openai.com/v1

Böylece prototipten üretime geçerken aynı istekleri ve prompt’ları kıyaslayabilirsiniz. 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ı?

Geliştirici tarafı için kullanım sizin OpenAI hesabınıza yazılmaz. Son kullanıcı kendi Puter hesabındaki bakiyeyi kullanır. Yeni hesaplar başlangıç kredisi alır; daha fazla kullanım için kullanıcı bakiye yükleyebilir.

OpenAI hesabına ihtiyacım var mı?

Hayır. Puter, OpenAI tarafındaki ilişkiyi yönetir. Uygulamanızda OpenAI API anahtarı tutmazsınız.

Bunu üretimde kullanabilir miyim?

Tarayıcı tabanlı uygulamalar için evet. Asıl karar noktası, kullanıcılarınızın Puter’a giriş yapmayı kabul edip etmeyeceğidir.

Puter üzerinden GPT-5.5 çıktısı resmi API ile aynı mı?

Model çıktısı aynı model ailesine dayanır; Puter çağrıyı kullanıcının adına yönetir. Ek bir katman olduğu için gecikme bir miktar farklı olabilir.

Prompt caching ne olacak?

Puter, OpenAI’ın prompt caching fiyatlandırma kontrollerini doğrudan sunmayabilir. Büyük ve sabit sistem prompt’larında cache indirimi kritikse resmi OpenAI API kullanmanız daha uygundur.

Backend servisinde kullanabilir miyim?

Temiz bir şekilde değil. Puter öncelikle tarayıcı ve kullanıcı oturumu bağlamına göre tasarlanmıştır. Backend servisleri için resmi OpenAI API daha doğru yoldur. Alternatifler için GPT-5.5 API’si Ücretsiz Nasıl Kullanılır makalesine bakabilirsiniz.

Varsayılan model olarak hangisini seçmeliyim?

  • Genel akıl yürütme: gpt-5.5
  • Yüksek hacimli sınıflandırma: gpt-5.4-nano
  • Zor akıl yürütme: gpt-5.5-pro
  • Uzun akıl yürütme zincirleri: o3

Kullanıcılarım çok ücretlendirilir mi?

Çoğu sohbet tarzı kullanım, oturum başına düşük maliyetlidir. Görüntü oluşturma daha pahalı olabilir. Bu yüzden:

  • max_tokens sınırı koyun.
  • Gereksiz tekrar çağrılarını engelleyin.
  • Görüntü oluşturma butonlarına loading state ve debounce ekleyin.

Puter ile görüntü oluşturabilir miyim?

Evet. txt2img() ile gpt-image-2 veya DALL-E modellerini kullanabilirsiniz. Resmi ücretli API kılavuzu için GPT-Image-2 API’si Nasıl Kullanılır makalesine bakın.

Özet

Puter.js, OpenAI modellerini tarayıcı tabanlı uygulamalara hızlıca eklemek için pratik bir yoldur. Script’i ekleyin, modeli seçin, puter.ai.chat() çağrısını yapın. OpenAI anahtarı yönetmezsiniz; kullanım son kullanıcının Puter hesabı üzerinden ilerler.

Sunucu tarafı iş yükleri, prompt caching, Responses API, Files API veya tam structured outputs gerekiyorsa resmi OpenAI API daha uygundur. Prototipler, hackathon projeleri, ücretsiz genel araçlar ve statik siteler için Puter daha hızlı başlangıç sağlar.

İsteği Apidog içinde bir kez modelleyin, Puter prototipini resmi API ile kıyaslayın ve projenizin gereksinimine göre devam edin.

Top comments (0)