GPT-5.3 Codex API Nasıl Kullanılır?

TL;DR

GPT-5.3 Codex, ilk sürümünden haftalar sonra API aracılığıyla nihayet kullanıma sunuldu. İki şekilde erişebilirsiniz:

1. OpenRouter - Model Kimliği openai/gpt-5.3-codex, rekabetçi fiyatlandırma
2. OpenAI Geliştirici Platformu - Model Kimliği gpt-5.3-codex, doğrudan erişim

Başlamak için: OpenRouter veya OpenAI platformuna kaydolun, API anahtarınızı alın ve standart Chat Completions uç noktasını kullanarak ilk isteğinizi yapın.

Giriş

Haftalarca geliştiriciler, GPT-5.3 Codex'i uygulamalarına entegre etmek istedi ancak bir sorun vardı. OpenAI modeli Codex Uygulaması, CLI ve IDE uzantıları aracılığıyla yayınlamış olsa da API erişilemez kalmıştı. Yapay zeka destekli geliştirme araçları, otomasyon süreçleri ve kodlama asistanları geliştiren ekipler beklemek zorunda kaldı.

Bu bekleyiş sona erdi.

GPT-5.3 Codex artık API aracılığıyla kullanılabilir, bu da geliştiricilere modelin piyasaya sürülmesinden bu yana talep ettikleri programatik erişimi sağlıyor. İki seçeneğiniz var:

1. OpenRouter - openrouter.ai üzerinden rekabetçi fiyatlandırma ve birleşik API ile erişim
2. OpenAI Geliştirici Platformu - developers.openai.com üzerinden doğrudan erişim

İster bir SaaS ürünü geliştiriyor, ister dahili araçları otomatikleştiriyor, ister yapay zeka yeteneklerini mevcut uygulamalarınıza entegre ediyor olun, GPT-5.3 Codex API, OpenAI'ın en yetenekli kodlama modelinden yararlanmak için basit bir yol sunar. Giriş token başına milyon başına sadece 0,00125 dolardan başlayan fiyatlandırma ve büyük kod tabanlarını işleyebilen bir bağlam penceresi sayesinde, hiç bu kadar erişilebilir olmamıştı.

Bu kılavuzda, GPT-5.3 Codex'i geliştirme iş akışınıza entegre etmek için bilmeniz gereken her şeyi adım adım inceleyeceğiz. OpenRouter hesabınızı kurmaktan üretimde kullanıma hazır API çağrıları yapmaya kadar, daha akıllı ve daha hızlı geliştirmeye başlamak için bilgiye sahip olacaksınız.

GPT-5.3 Codex Nedir?

OpenAI tarafından yayımlanan GPT-5.3 Codex, kod üretimi, anlama ve hata ayıklama görevleri için özel olarak optimize edilmiştir. Genel amaçlı dil modellerinin aksine, Codex çok büyük miktarda programlama kodu üzerinde eğitilmiştir, bu da onu aşağıdaki konularda son derece başarılı kılar:

• Kod Üretimi: Açıklamalardan fonksiyonlar, sınıflar ve hatta tüm uygulamalar yazın
• Kod Anlama: Bilinmeyen kodun ne yaptığını açıklayın ve iyileştirmeler önerin
• Hata Ayıklama: Hataları tespit edin ve düzeltmeler önerin
• Dokümantasyon: Docstring'ler ve API dokümantasyonu oluşturun
• Yeniden Düzenleme: İşlevselliği değiştirmeden kod yapısını iyileştirin

OpenRouter aracılığıyla erişilebilen sürüm (openai/gpt-5.3-codex), tek bir istekte orta büyüklükte bir kod tabanının tamamını yüklemek için yeterli olan 400.000 tokenlık bir bağlam penceresini destekler. Bu, birden çok dosyadaki geniş kod ilişkilerini anlamayı gerektiren görevler için idealdir.

Neden OpenRouter Kullanmalı?

OpenRouter, çeşitli sağlayıcılardan birden fazla yapay zeka modeline tek, tutarlı bir arayüz aracılığıyla erişim sağlayan birleşik bir API ağ geçidi görevi görür.

İşte geliştiricilerin GPT-5 Codex'e erişim için OpenRouter'ı seçme nedenleri:

1. Birleşik API: Tek bir API anahtarı düzinelerce modele erişir
2. Rekabetçi Fiyatlandırma: Genellikle doğrudan API erişiminden daha ucuz
3. Hız Sınırı Yok: Kullanıma dayalı esnek kotalar
4. Kolay Geçiş: Kodunuzu değiştirmeden modelleri değiştirin
5. Ücretsiz Krediler: Yeni hesaplar başlamak için 1$ ücretsiz kredi alır

Zaten OpenRouter aracılığıyla başka modeller kullanıyorsanız, GPT-5 Codex eklemek mevcut API çağrılarınızdaki model kimliğini değiştirmeniz yeterlidir.

OpenRouter ve OpenAI Geliştirici Platformu Karşılaştırması

GPT-5.3 Codex'e API aracılığıyla erişmek için iki seçeneğiniz var:

OpenRouter'ı Seçin eğer: Birden fazla LLM sağlayıcısına birleşik erişim, rekabetçi fiyatlandırma ve modelleri değiştirme esnekliği istiyorsanız.

OpenAI Geliştirici Platformunu Seçin eğer: Doğrudan erişimi tercih ediyor, zaten OpenAI API'lerini kullanıyor ve resmi destek istiyorsanız.

Her iki seçenek de aynı temel GPT-5.3 Codex modelini sağlar; fark fiyatlandırma, kolaylık ve mevcut kurulumunuzdadır.

Erişim Seçeneği 1: OpenAI Geliştirici Platformu

OpenAI'ın resmi API'si aracılığıyla doğrudan erişimi tercih ediyorsanız, işte nasıl başlayacağınız:

Adım 1: OpenAI Hesabı Oluşturun

platform.openai.com adresine gidin ve kaydolun veya oturum açın.

Adım 2: API Anahtarınızı Oluşturun

1. Sol kenar çubuğundaki API Anahtarları'na gidin
2. Yeni gizli anahtar oluştur'a tıklayın
3. Anahtarınızı kopyalayın ve kaydedin (yalnızca bir kez gösterilir)

Adım 3: İlk İsteğinizi Yapın

curl -X POST https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.3-codex",
    "messages": [
      {
        "role": "user",
        "content": "Write a Python function that calculates the factorial of a number."
      }
    ]
  }'

YOUR_OPENAI_API_KEY'i gerçek API anahtarınızla değiştirin.

Python Örneği (OpenAI Doğrudan)

import os
from openai import OpenAI

client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))

response = client.chat.completions.create(
    model="gpt-5.3-codex",
    messages=[
        {
            "role": "user",
            "content": "Create a REST API endpoint in FastAPI for user authentication"
        }
    ],
    temperature=0.7,
    max_tokens=2000
)

print(response.choices[0].message.content)

Erişim Seçeneği 2: OpenRouter

Adım 1: Hesabınızı Oluşturun

openrouter.ai adresine gidin ve e-postanızla kaydolun. Kayıt işlemi iki dakikadan az sürer.

Adım 2: API Anahtarınızı Alın

Oturum açtıktan sonra profil simgenize tıklayın ve "API Anahtarları"nı seçin. Yeni bir anahtar oluşturun ve hemen kopyalayın; güvenlik nedenleriyle anahtarlar yalnızca bir kez gösterilir.

Adım 3: Kredi Ekleyin

Yeni hesaplar 1$ ücretsiz kredi alsa da, sürekli kullanım için daha fazlasını eklemek isteyeceksiniz. "Krediler"e gidin ve kredi kartı veya diğer desteklenen yöntemlerle para ekleyin. Normal geliştirme için minimum 5-10$ tavsiye edilir.

Adım 4: Model Kullanılabilirliğini Doğrulayın

OpenRouter kontrol panelinde, mevcut olduğunu doğrulamak için "gpt-5.3-codex"i arayın. Kullanacağınız model kimliği openai/gpt-5.3-codex'tir.

İlk API Çağrınızı Yapma

Kurulumunuzu test etmenin en basit yolu curl kullanmaktır. Terminalinizi açın ve çalıştırın:

curl -X POST https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "HTTP-Referer: https://your-site.com" \
  -d '{
    "model": "openai/gpt-5.3-codex",
    "messages": [
      {
        "role": "user",
        "content": "Write a Python function that calculates the factorial of a number."
      }
    ]
  }'

YOUR_OPENROUTER_API_KEY'i gerçek anahtarınızla ve https://your-site.com'u web sitenizin URL'siyle değiştirin (OpenRouter tarafından analitik için gereklidir).

Üretilen kodu içeren bir JSON yanıtı almalısınız. Tebrikler—ilk GPT-5.3 Codex API çağrınızı yaptınız.

Python Entegrasyonu

Python uygulamaları için, OpenAI SDK'sını özel bir temel URL ile kullanabilirsiniz:

Kurulum

pip install openai requests python-dotenv

Temel Kullanım

import os
from openai import OpenAI
from dotenv import load_dotenv

load_dotenv()

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.getenv("OPENROUTER_API_KEY"),
)

def generate_code(prompt: str) -> str:
    """Generate code using GPT-5.3 Codex via OpenRouter."""
    response = client.chat.completions.create(
        model="openai/gpt-5.3-codex",
        messages=[
            {
                "role": "system",
                "content": "You are an expert programmer. Write clean, well-documented code."
            },
            {
                "role": "user",
                "content": prompt
            }
        ],
        temperature=0.7,
        max_tokens=2000
    )

    return response.choices[0].message.content

# Example usage
code = generate_code("Create a REST API endpoint in FastAPI for user authentication")
print(code)

Akış Yanıtları

Daha uzun kod üretimi için akış, daha iyi bir kullanıcı deneyimi sunar:

def generate_code_streaming(prompt: str):
    """Generate code with streaming responses."""
    response = client.chat.completions.create(
        model="openai/gpt-5.3-codex",
        messages=[{"role": "user", "content": prompt}],
        stream=True,
        temperature=0.7
    )

    for chunk in response:
        if chunk.choices[0].delta.content:
            print(chunk.choices[0].delta.content, end="", flush=True)

# Example usage
generate_code_streaming("Write a React component for a file upload button")

Hata Yönetimi

Üretim uygulamaları için her zaman uygun hata yönetimini uygulayın:

import json

def generate_code_safe(prompt: str) -> dict:
    """Generate code with proper error handling."""
    try:
        response = client.chat.completions.create(
            model="openai/gpt-5.3-codex",
            messages=[{"role": "user", "content": prompt}],
            temperature=0.7,
            max_tokens=2000
        )

        return {
            "success": True,
            "code": response.choices[0].message.content,
            "usage": {
                "prompt_tokens": response.usage.prompt_tokens,
                "completion_tokens": response.usage.completion_tokens,
                "total_tokens": response.usage.total_tokens
            }
        }

    except Exception as e:
        return {
            "success": False,
            "error": str(e)
        }

# Check token usage
result = generate_code_safe("Write a Python decorator for logging")
if result["success"]:
    print(f"Token usage: {result['usage']['total_tokens']} tokens")

Node.js Entegrasyonu

JavaScript ve TypeScript geliştiricileri, OpenAI SDK'sını veya yerel fetch'i kullanarak GPT-5.3 Codex'i entegre edebilir:

Kurulum

npm install openai

Temel Kullanım

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
  defaultHeaders: {
    "HTTP-Referer": "https://your-site.com",
    "X-Title": "Your App Name",
  },
});

async function generateCode(prompt) {
  const completion = await openai.chat.completions.create({
    model: "openai/gpt-5.3-codex",
    messages: [
      {
        role: "system",
        content: "You are an expert full-stack developer. Write production-ready code.",
      },
      {
        role: "user",
        content: prompt,
      },
    ],
    temperature: 0.7,
    max_tokens: 2000,
  });

  return completion.choices[0].message.content;
}

// Example usage
const code = await generateCode("Create a Python function for binary search");
console.log(code);

Yerel Fetch Kullanımı

async function generateCodeFetch(prompt) {
  const response = await fetch(
    "https://openrouter.ai/api/v1/chat/completions",
    {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${process.env.OPENROUTER_API_KEY}`,
        "Content-Type": "application/json",
        "HTTP-Referer": "https://your-site.com",
        "X-Title": "Your App Name",
      },
      body: JSON.stringify({
        model: "openai/gpt-5.3-codex",
        messages: [{ role: "user", content: prompt }],
        temperature: 0.7,
        max_tokens: 2000,
      }),
    }
  );

  const data = await response.json();
  return data.choices[0].message.content;
}

Gelişmiş Parametreler ve Seçenekler

GPT-5.3 Codex, API çağrılarınızı ince ayar yapmak için çeşitli parametreleri destekler:

Sıcaklık

Rastgeleliği kontrol eder. Daha düşük değerler (0.1-0.3) daha deterministik çıktı üretir—tutarlılığın önemli olduğu kod üretimi için idealdir:

response = client.chat.completions.create(
    model="openai/gpt-5.3-codex",
    messages=[{"role": "user", "content": "Write a sorting algorithm"}],
    temperature=0.2,  # Low for consistent, predictable code
)

Maksimum Token

Maliyetleri kontrol etmek için yanıt uzunluğunu sınırlayın:

response = client.chat.completions.create(
    model="openai/gpt-5.3-codex",
    messages=[{"role": "user", "content": "Explain this entire codebase"}],\
    max_tokens=4000,  # Limit response length
)

Top P

Çıktı çeşitliliğini kontrol etmek için sıcaklığa alternatif:

response = client.chat.completions.create(
    model="openai/gpt-5.3-codex",
    messages=[{"role": "user", "content": "Write a function"}],
    top_p=0.9,
)

Durdurma Dizileri

Üretimi durduran dizeleri belirtin:

response = client.chat.completions.create(
    model="openai/gpt-5.3-codex",
    messages=[{"role": "user", "content": "Write Python code"}],
    stop=["```", "###"],  # Stop at code blocks
)

Apidog ile Üretilen Kodu Doğrulama

Birçok geliştiricinin takıldığı yer burasıdır. GPT-5.3 Codex'ten "bir API oluşturmasını" istersiniz, geçerli görünen bir kod üretir ve sonra neden çalışmadığını ayıklamakla saatler harcarsınız. Çözüm: Dağıtımdan önce doğrulayın.

İş Akışı

1. Spesifikasyonu Oluşturun: Codex'ten sadece kod değil, bir OpenAPI spesifikasyonu isteyin
2. Apidog'a Aktarın: Spesifikasyonu doğrulayın ve test senaryoları oluşturun
3. Uygulamayı Test Edin: Üretilen koda karşı otomatik testler çalıştırın

Örnek: Bir API Spesifikasyonunu Doğrulama

# Ask Codex to generate an OpenAPI spec, not just code
prompt = """
Create a REST API for a task management application.
Output the complete OpenAPI 3.0 specification in YAML format.
Include:
- Endpoints for CRUD operations on tasks
- Authentication using Bearer tokens
- Error responses for 400, 401, 404, 500
- Request/response examples
"""

Spesifikasyonu aldıktan sonra,