AlestaSoft

OpenAI'nın en güçlü modeli GPT-5.4 artık kullanıma açık! Bu rehberde GPT-5 API'sini Python ile sıfırdan nasıl kullanacağınızı, yeni özellikleri ve pratik kod örneklerini öğreneceksiniz.
GPT-5 Nedir? Hangi Sürümler Mevcut?
Mart 2026 itibarıyla OpenAI'nın sunduğu GPT-5 ailesi:
| Model | Özellik | Context |
|---|---|---|
| gpt-5.4 | En güncel, computer use + reasoning | 1M+ token |
| gpt-5.2 | xhigh reasoning, compaction | 128K token |
| gpt-5 | Temel GPT-5, Chat Completions drop-in | 128K token |
GPT-5.4 Yeni Özellikler
- Ayarlanabilir Reasoning Effort:
low,medium,high,xhighseçenekleri ile maliyet/performans dengesi kurabilirsiniz - Native Computer Use: Ekran görüntüsü yorumlama ve UI otomasyonu artık yerleşik
- 1M+ Token Context: GPT-5.4 ile devasa belgeler tek seferde işlenebilir
- Context Compaction: GPT-5.2'de uzun konuşmaları sıkıştırarak maliyet düşürme
- Gelişmiş Kod Üretimi: Daha az hata, daha iyi refactoring önerileri
Kurulum ve API Key
1. OpenAI Python SDK Kurulumu
# OpenAI SDK'yı kur
pip install openai
# Sürümü doğrula
python -c "import openai; print(openai.__version__)"2. API Key Ayarı
# Linux/Mac
export OPENAI_API_KEY="sk-proj-xxxxxxxxxxxxxxxxxxxx"
# Windows (PowerShell)
$env:OPENAI_API_KEY="sk-proj-xxxxxxxxxxxxxxxxxxxx"
# Kalıcı yapmak için .env dosyası kullanın:
pip install python-dotenv.env dosyası veya ortam değişkeni kullanın ve .gitignore'a ekleyin.İlk GPT-5 API İsteği
Temel Python Örneği
from openai import OpenAI
client = OpenAI() # OPENAI_API_KEY ortam değişkeninden okur
response = client.chat.completions.create(
model="gpt-5.4",
messages=[
{
"role": "system",
"content": "Sen yardımsever bir asistansın. Türkçe yanıt ver."
},
{
"role": "user",
"content": "Python ile basit bir web scraper yaz."
}
],
max_tokens=1000,
temperature=0.7
)
print(response.choices[0].message.content)
print(f"\nKullanılan tokenlar: {response.usage.total_tokens}")usage.total_tokens ile kaç token harcandığını görebilirsiniz.Reasoning Effort Ayarı
GPT-5.4'ün en önemli özelliği reasoning_effort parametresidir. Karmaşık problemler için yüksek, basit görevler için düşük ayarlayarak maliyeti optimize edebilirsiniz.
Reasoning Effort Kullanımı
from openai import OpenAI
client = OpenAI()
# Karmaşık matematik/kod problemi için xhigh reasoning
response = client.chat.completions.create(
model="gpt-5.4",
reasoning_effort="xhigh", # low | medium | high | xhigh
messages=[
{
"role": "user",
"content": "Bu O(n²) algoritmayı O(n log n)'e optimize et: [kod]"
}
]
)
# Basit görevler için low (daha ucuz)
quick_response = client.chat.completions.create(
model="gpt-5.4",
reasoning_effort="low",
messages=[{"role": "user", "content": "Merhaba de."}]
)| Seviye | Kullanım Alanı | Maliyet |
|---|---|---|
low | Basit Q&A, sınıflandırma | En düşük |
medium | Genel görevler | Orta |
high | Kod üretimi, analiz | Yüksek |
xhigh | Karmaşık matematik, araştırma | En yüksek |
Streaming Yanıtlar
Uzun yanıtlarda kullanıcı deneyimini iyileştirmek için streaming kullanın. Yanıt tamamlanmayı beklemeden parça parça gelir.
Streaming API Örneği
from openai import OpenAI
client = OpenAI()
with client.chat.completions.stream(
model="gpt-5.4",
messages=[
{"role": "user", "content": "Python'da async/await kullanımını anlat."}
]
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
print() # Yeni satırMaliyet ve Token Yönetimi
Token Sayısını Önceden Hesapla
import tiktoken
def token_sayisi(metin: str, model: str = "gpt-5.4") -> int:
enc = tiktoken.encoding_for_model(model)
return len(enc.encode(metin))
metin = "Bu uzun bir metin örneğidir..."
print(f"Token sayısı: {token_sayisi(metin)}")Yaygın Hata Çözümleri
❌ AuthenticationError: Invalid API Key
# API key'i kontrol et
echo $OPENAI_API_KEY
# Python'da test et:
import openai
print(openai.api_key[:10]) # İlk 10 karakteri göster❌ RateLimitError: 429 Too Many Requests
import time
from openai import RateLimitError
def gpt_iste(mesaj, max_deneme=3):
for deneme in range(max_deneme):
try:
return client.chat.completions.create(
model="gpt-5.4",
messages=[{"role": "user", "content": mesaj}]
)
except RateLimitError:
if deneme < max_deneme - 1:
time.sleep(2 ** deneme) # Exponential backoff
else:
raise❌ ContextLengthExceeded
# GPT-5.4 ile 1M token context kullanın:
model="gpt-5.4" # 1M+ token destekler
# veya içeriği kısaltın:
max_tokens=128000
temperature=0✅ GPT-5 ile Geliştirmeye Başlayın!
GPT-5.4 API'si, reasoning effort kontrolü ve 1M token context ile 2026'nın en güçlü yapay zeka geliştirme platformu olmaya devam ediyor.
Öğrendikleriniz:
- ✅ GPT-5 sürümleri ve farkları
- ✅ Python SDK kurulumu
- ✅ İlk API isteği
- ✅ Reasoning effort optimizasyonu
- ✅ Streaming kullanımı
- ✅ Hata yönetimi
Faydalı Linkler:
- OpenAI Docs: platform.openai.com/docs
- AlestaWeb: alestaweb.com
© 2026 AlestaWeb - Tüm hakları saklıdır.

