GPT-5 API Python Rehberi: Sıfırdan Yapay Zeka Geliştirme (2026)

17.03.2026 20:28 Haber

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.4En güncel, computer use + reasoning1M+ token
gpt-5.2xhigh reasoning, compaction128K token
gpt-5Temel GPT-5, Chat Completions drop-in128K token
ℹ️ Önemli: GPT-5 serisi, Chat Completions API ile tam uyumludur. GPT-4 kullanan mevcut kodunuzu sadece model adını değiştirerek GPT-5'e geçirebilirsiniz.

GPT-5.4 Yeni Özellikler

  • Ayarlanabilir Reasoning Effort: low, medium, high, xhigh seç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
⚠️ Güvenlik: API key'inizi asla kod içine yazmayın. .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}")
✅ Beklenen Çıktı: GPT-5 Python kodu ile birlikte açıklamalı yanıt döner. 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
lowBasit Q&A, sınıflandırmaEn düşük
mediumGenel görevlerOrta
highKod üretimi, analizYüksek
xhighKarmaşık matematik, araştırmaEn 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ır

Maliyet 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)}")
ℹ️ Maliyet İpucu: GPT-5.4 fiyatlandırması için openai.com/pricing sayfasını kontrol edin. Batch API ile %50'ye kadar indirim alabilirsiniz.

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:

© 2026 AlestaWeb - Tüm hakları saklıdır.

WM Tools
💫

WebMaster Tools

15 Profesyonel Araç
Alesta AI
Alesta AI
Online