Codex API'si nedir?
codex api terimi genel olarak kod üretimi ve anlaşılması için özel olarak eğitilmiş AI modelleri tarafından kullanılan arayüzü ifade eder. Orijinal olarak OpenAI tarafından popüler hale getirilen bu kavram, çeşitli sağlayıcıların OpenAI uyumlu uç noktalar sunduğu daha geniş bir standart haline gelmiştir. AI kodlama ajanları için bu, metin-girişi, metin-çıkışı etkileşimlerini yöneten tutarlı bir POST /v1/chat/completions yapısı anlamına gelir.
Hizmetimiz, kodlama bağlamları için optimize edilmiş özel bir sansürsüz büyük dil modeli sağlar. Birden fazla sağlayıcıyı birleştiren vekil sunucuların aksine, tek bir açık ağırlıklı modeli kendi GPU sunucularımızda çalıştırıyoruz. Bu, büyük kod tabanlarını bağlam kaybı olmadan işlemek için kritik olan 100.000 token'lık bir bağlam penceresine sahip stabil, tek modelli bir uç nokta sağlar.
API, gömme (embedding), görüntü, ses veya video üretimini desteklemez ve ince ayar (fine-tuning) sunmaz. Sadece Cursor veya Claude Code gibi kodlama ajanlarına doğrudan entegre olmak üzere tasarlanmış metin tabanlı bir tamamlama motorudur.
Neden Sansürsüz Model Kullanılır?
Standart kodlama modelleri genellikle teknik görevlerle karışabilecek içerik filtreleri uygular. Örneğin, bir model bir güvenlik açığı için kod oluşturmayı reddedebilir veya belirli bir programlama dili sözdizimini telif hakkı ihlali gibi göründüğü için engelleyebilir, hatta kullanım yasal ve teknik olsa bile. Sansürsüz bir model bu keyfi reddiye durumlarını kaldırır ve ajanın yalnızca kod kalitesi ve mantığına odaklanmasını sağlar.
Modelimiz, yasal yetişkin kullanım için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır. Bu, çeşitli kod parçacıkları, dokümantasyon veya yaratıcı kodlama projelerini içerik politikası nedeniyle 403 Forbidden hatası almadan işlemesi gereken AI kodlama ajanları için özellikle faydalıdır.
Her zaman geçerli olan tek bir katı içerik sınırı vardır: çocuklarla ilgili cinsel içerik yoktur. Bu tür istekler engellenir. Diğer tüm yasal yetişkin, kurgusal veya güvenlik araştırması konuları için model doğrudan yanıt verecektir. Bu stabilite, ajanınızın iş akışında yeniden deneme mantığına olan ihtiyacı azaltır, token ve zaman tasarrufu sağlar.
Cursor IDE Yapılandırması
Cursor IDE, harici LLM uç noktalarına güvenen popüler bir AI destekli kod editörüdür. Sansürsüz API'mizi birincil kodlama ajanınız olarak kullanmak için ayarlarınızdaki temel URL'yi güncellemeniz gerekir.
Cursor ayarlarınıza gidin ve API yapılandırma bölümünü bulun. Temel URL'yi https://api.getcodexapi.com/v1 olarak değiştirin. API anahtarını al sayfasından API anahtarınızı girin. Seçmeniz gereken model kimliği uncensored olmalıdır.
Bu yapılandırma, tüm kod önerilerinin ve düzenlemelerin özel modelimiz tarafından işlenmesini sağlar. Cursor OpenAI uyumlu formatı kullandığından ek bir ara yazılıma gerek yoktur. 100.000 token'lık bağlam penceresi, editörün büyük dosyalarda veya çok dosyalı yeniden yapılandırma görevlerinde bağlamı korumasını sağlar; bu, daha küçük bağlam modellerinde yaygın bir sınırlamadır.
Trade-off: Özel GPT-4 veya Claude gibi modellere erişiminiz olmayacaktır; ancak saf kod üretimi ve düzenleme için bu sansürsüz uç nokta genellikle politika kesintileri olmadan daha hızlı ve tutarlı sonuçlar sağlar.
Claude Code Bağlantısı
Claude Code, Anthropic tarafından geliştirilen bir komut satırı ajanıdır. Genellikle Anthropic API'sini kullansa da, istemci destekliyorsa herhangi bir OpenAI uyumlu uç noktayı yapılandırmak mümkündür. Bu, modelimizin sansürsüz davranışını tercih eden ancak Claude Code arayüzünü seven kullanıcılar için API'mizi geçerli bir alternatif haline getirir.
Bağlantı için istemcinizin özel temel URL'leri desteklediğinden emin olmanız gerekir. Yapılandırmayı https://api.getcodexapi.com/v1 adresine yönlendirecek şekilde güncelleyin ve modeli uncensored olarak ayarlayın. Ayrıca API anahtarınızı da sağlamanız gerekecektir.
Bu kurulum, kodlama ajanının sağlam araç çağırma yeteneklerini isteyen ancak karmaşık veya alışılmadık kod desenlerini reddetmeyen bir modele ihtiyaç duyan geliştiriciler için faydalıdır. Arayüz aynı kalsa da, altta yatan modelin davranışı standart Claude modellerinden farklı olacaktır. Sansürsüz modelin kod kalitesi standartlarınızı karşıladığından emin olmak için belirli iş akışlarınızı her zaman test edin.
OpenAI SDK Kullanımı
Python veya Node.js için OpenAI SDK'sı, herhangi bir OpenAI uyumlu uç nokta ile çalışacak şekilde tasarlanmıştır. Temel URL'yi ve API anahtarını değiştirerek API'mizi kullanabilirsiniz.
İstemciyi Python'da başlatmak için aşağıdaki kodu kullanabilirsiniz:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getcodexapi.com/v1",
api_key="your-api-key"
)
Ardından, sohbet tamamlamaları uç noktasına normal şekilde çağrı yapabilirsiniz:
response = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a Python function to sort a list."}]
)
Bu sadelik, altta yatan modeli ajanınızın temel mantığını yeniden yazmadan değiştirmenizi sağlar. SDK, serileştirme ve yanıt ayrıştırmayı yönetir, böylece uygulama mantığına odaklanabilirsiniz.
Gerçek Zamanlı Geri Bildirim İçin Akış
Gerçek zamanlı kod önerileri sunan kodlama ajanları için akış (streaming) esastır. API'miz, akış yanıtları için Sunucu Tarafından Gönderilen Olayları (SSE) destekler. Bu, ajanın kodu oluşturulurken görüntülemesini sağlar ve kullanıcı deneyimini iyileştirir.
- API isteğinizde
stream=Trueayarını yapın. - Akışı parça parça okuyun.
- Her parça için kullanıcı arayüzünü veya editörü güncelleyin.
Bu, özellikle büyük kod blokları için algılanan gecikmeyi azaltır. Modelimiz 100,000 token bağlam penceresine sahip olduğundan, büyük miktarda bağlam içeren yanıtları kesilme endişesi olmadan akış yapabilirsiniz.
Not: Akış, fiyatlandırmayı veya token sayımını değiştirmez. Tokenlar, yanıt akış halinde mi yoksa tek bir blok halinde mi döndürüldüğünden bağımsız olarak toplam girdi ve çıktı bazında faturalandırılır.
Araç Fonksiyon Çağrılarının Yönetimi
AI kodlama ajanları, harici araçlarla etkileşim kurmak için fonksiyon çağırma özelliğini sıklıkla kullanır; örneğin bir terminal komutu çalıştırmak veya bir dosya okumak gibi. API'miz bu özelliği destekler ve isteklerinizde fonksiyon şemalarını tanımlamanıza olanak tanır.
- Fonksiyonlarınızı
functionsparametresi içinde tanımlayın. - Model, bir
function_callnesnesi içeren bir yanıt döndürecektir. - Ajanınız fonksiyonu çalıştırır ve sonucu modele geri gönderir.
- Model, sonuca dayanarak bir sonraki yanıtı üretir.
Bu çok adımlı etkileşim, karmaşık kodlama görevleri için kritik öneme sahiptir. Örneğin bir ajan bir dosyayı okuyup analiz etmeli ve ardından bir düzeltme üretmelidir. API'miz bu süreci sorunsuz yönetir ve 100,000 token sınırlaması içindeki çok adımlı bağlamı korur.
Hız Limitlerinin Yönetimi
Adil kullanım ve istikrarı sağlamak için API'miz, anahtar başına dakikada 300 istek için bir limit uygular. Maksimum istek gövdesi boyutu 8 MB'tır. Bu limitleri aşmanız durumunda 429 Too Many Requests hatası alırsınız.
En iyi uygulamalar:
- Ajanınızın yeniden deneme mantığında üstel geri çekilme (exponential backoff) uygulayın.
- Büyük yanıtlar için API çağrı sayısını azaltmak amacıyla akış özelliğini kullanın.
- Beklenmedik ücretlerden kaçınmak için kullanımınızı panelden izleyin.
Anahtarları değiştirmeniz gerekirse, API anahtarınızı istediğiniz zaman yeniden oluşturabilirsiniz. Bu işlem eski anahtarı geçersiz kılar; bu nedenle yeniden oluşturmadan önce ajanlarınızı güncellemeniz önemlidir.
