Codex VS Code API Anahtarı: Özel Uç Nokta Kullanın

Kurulumunuz

VS Code'daki kod asistanları, bir modele HTTP üzerinden bağlanır. Çoğu OpenAI API formatını kullanır; bu da satıcı varsayılanı yerine özel bir Base URL ve API anahtarı kabul ettikleri anlamına gelir. Bu hizmet OpenAI-uyumludur, bu nedenle bu seçeneği sunan herhangi bir araca bağlanabilir.

Karşısındakilerin ne olduğunu netleştirin. Bağımsız bir sağlayıcı tarafından yürütülen, yasal yetişkin kullanım için içerik reddi olmadan cevap verecek şekilde ayarlanmış tek bir açık ağırlıklı modeldir. OpenAI'nin Codex modeli veya başka bir satıcının resmi API'si değildir. Sadece metin içerir, 100.000 token penceresi, fonksiyon çağırma ve JSON modu vardır. OpenAI tarzı yolların ayrıntılarını okumak için dokümantasyon; yalnızca adresi görmek için Codex API base URL sayfasına bakın.

Her yerde kullanmanız gereken üç değer şunlardır:

Anahtar alın ve önce test edin

Google veya e-posta ile şifre kullanarak API anahtarı sayfası üzerinde bir hesap oluşturun. Yeni kullanıcılar tek tıkla 7 gün boyunca geçerli $0,50 deneme kredisi talep edebilir, kart gerekmez. Ardından VS Code'a dokunmadan anahtarı bir terminalde test edin. Çalışan bir curl çağrısı anahtarı ve URL'yi kanıtlar, böylece sonraki hatalar uzantıya ilişkindir.

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

Yanıt sohbet tamamlamaları JSON'dur ve yanıt, kalan kredinizi gösteren X-Balance-USD başlığını taşır. Anahtarı bir ortam değişkeninde veya uzantının gizli depolamasında tutun, depoda asla saklamayın.

Codex uzantısı ve CLI: yapılandırma dosyası

OpenAI'nin Codex araçları, ev dizininizdeki bir TOML yapılandırma dosyası aracılığıyla özel model sağlayıcılarını destekler ve VS Code uzantısının bu yapılandırmayı CLI ile paylaşması belgelenmiştir. Format evrildiğinden, sürümünüz için güncel Codex belgelerine göre doğrulayın.

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

Kontrol edilecek noktalar:

• base_url /v1 ile biter, /chat/completions içermez.
• env_key anahtarın kendisi değil, ortam değişkeninin adıdır.
• wire_api istek formatını seçer. Bu hizmet hem POST /v1/chat/completions hem de POST /v1/responses kabul eder. Önce "chat"i deneyin; Codex sürümünüz bunu gerektiriyorsa "responses" kullanın.
• Değişkeni ayarlayan bir kabuktan VS Code'u başlatın veya değişkeni profilinize ekledikten sonra yeniden başlatın. macOS'ta GUI başlatma genellikle kabuk dışa aktarmalarını görmez.

Aracı tarzı araçlar fonksiyon çağırma'ya dayanır. Burada desteklenir, akışlı fonksiyon çağrıları dahil, ancak kalite modele göre değişir, bu yüzden önce küçük bir görev çalıştırın. Cursor'da API kullanma sayfası başka bir editörde benzer bir kurulumu kapsar.

Continue, Cline ve diğer uzantılar

Üçüncü taraf uzantıların her birinin kendi ekranı vardır ancak desen sabittir: OpenAI veya "OpenAI uyumlu" sağlayıcıyı seçin, ardından base URL, anahtar ve modeli doldurun. Continue bir YAML yapılandırması kullanır:

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

Cline ve Roo Code, ayarlar panelinde aynı üç alanı içeren bir "OpenAI Uyumlu" sağlayıcı sunar. İsimler ve menüler sık değişir, bu nedenle "OpenAI compatible" veya "custom base URL" için uzantının kendi belgelerine bakın. Bir uzantının base URL için bir alanı yoksa, bu uç noktayı kullanamaz.

Zamandan tasarruf sağlayan ipuçları:

• Her duraklamada bir istek göndermek istemiyorsanız, barındırılan modele karşı tab-tamamlamayı devre dışı bırakın. Sohbet ve düzenleme eylemleri daha ucuzdur.
• Günlük düzenlemeler için uzantıda daha küçük bir bağlam penceresi ayarlayın. Tüm depoları modele göndermek her seferinde girdi token'larına mal olur.
• Hangi aracın kredinizi kullandığını ayırt edebilmek için her araç için ayrı bir anahtar kullanın.

Bu modele hangi editör görevleri uygun

Tanımadığın kodu açıklamak, bir işlev için birim testleri yazmak, bir betiği diller arasında dönüştürmek, docstring ve regex taslağı oluşturmak ve tüm dosyayı yapıştırdığında bir modülü yeniden yazmak gibi birçok günlük iş için uygun bir seçenektir. 100.000 token'lık pencere, birkaç orta boy dosya ve talimatlarının tek bir istekte sığmasını ve tamamlamanın kalanı kullanmasını sağlar.

Kalan konularda gerçekçi olun. Editör farkındalığı ile eğitilmiş özel bir kodlama modeli olmadığından, büyük çok dosyalı ajan çalışmaları için size bir araç için vereceğiniz rehberlikten ve kontrolden daha fazla yönlendirme ve kontrol gerekebilir. Tüm dosyalar yerine farkları isteyin, kabul etmeden önce her değişikliği gözden geçirin ve testlerinizi çalıştırın. Filtreli bir asistanın reddettiği bir içeriğe ihtiyaç varsa (örneğin yetişkin kurgu iskeleti yazmak veya yasal kullanım için güvenlik araştırması metni), bu uç noktayı kullanmanız için neden, içerik reddi olmayan bir uç noktadır.

Editörde maliyeti ne

Fiyatlar 1M girdi token başına $0,15 ve 1M çıktı token başına $0,50'dir. Kodlama araçları çok bağlam gönderir, bu yüzden önce girdiye bakın.

Örnek: 8.000 token dosya bağlamı ve 600 token'lık bir cevap içeren bir düzenleme isteği, 8.000 x $0,15 / 1M + 600 x $0,50 / 1M = $0,0012 + $0,0003 = $0,0015 maliyetine sahiptir. 150 böyle isteklik bir günü 150 x $0,0015 = $0,225 eder. Yirmi çalışma günü: $4,50.

Çok dosya okuyan bir aracı adım başına 40.000 token gönderebilir. Bu boyutta bir adım $0,006 artı çıktı maliyetine sahiptir, bu yüzden 100 adım yaklaşık $0,60 artı çıktı eder. Aracı döngülerine dikkat edin. Başarısız veya reddedilen istekler ücretlendirilmez ve kredi süresi dolmaz. $20 ile $500 arası yüklemeler kart (Visa, Mastercard, Apple Pay, Google Pay) veya kripto ile yapılabilir. Güncel planlar fiyatlandırma sayfası üzerinde listelenmiştir.

Sorun Giderme

401 Yetkisiz

Anahtar eksik, yabancı bir boşluk içeriyor veya ortam değişkeni VS Code tarafından görünür değil. Değişkeni içeren bir terminalden editörü yeniden başlatın.

404 veya "model bulunamadı"

Tam olarak uncensored modelini ve sonunda /v1 olan base URL'yi kullanın.

429 hataları

Tam bir anahtar 8 eşzamanlı istek ve dakikada 300 izin verir; deneme anahtarı 2 ve 60 izin verir. Otomatik tamamlama ve sohbet gibi birkaç eşzamanlı istek tetikleyen bir uzantı, eşzamanlılık limitine ulaşabilir. Hata kodu, aynı anda çok fazla istek için concurrency ve dakika başı limitler için rate_limited şeklindedir. Bir Retry-After: 5 başlığı geçici aşırı yüklenmeyi ifade eder.

Akış takılır

Bazı kurumsal proxy'ler sunucu tarafından gönderilen olayları arabelleğe alır. Farklı bir ağdan test edin veya uzantıda akışı kapatın.

Yanıtlar başka bir asistanla gördüklerinizden farklı

Bu beklenendir. Bu, kendi güçlü yönlerine sahip farklı bir modeldir. Net, spesifik talimatlar verin ve kendi projenizdeki kodda test edin.

Daha fazla kılavuz

• Python'da Codex API: Bir Kodlama LLM'sini Çağırmak
• Codex API Base URL: İstemcinizi Bizimkine Nasıl Yönlendirirsiniz