Codex kurulumu · güncelleme 2026-08-26

Codex'i Model.sale'e bağlayın.

Codex CLI'de, Codex uygulamasında veya VS Code'da tek bir ön ödemeli Model.sale anahtarı kullanın. Bağlantı Responses protokolünü kullanır, gizli anahtarı yerel tutar ve diğer API kullanımınızla aynı cüzdandan ücretlendirir.

01 · Hazırlık
Hesap ve bakiyePanelde bir anahtar oluşturun ve en az 5 $ ekleyin. Tutarlar bir istekten önce ayrılır ve bildirilen kullanıma göre mutabık hale getirilir.
02 · Yapılandırma
Responses endpoint'iBase URL olarak https://api.model.sale/v1 kullanın ve /v1/models tarafından döndürülen bir model seçin.
03 · Doğrulama
İlk istekKüçük bir istem gönderin, istek kimliğini doğrulayın, ardından Kullanım'da token'ları ve kesin ücreti inceleyin.

Başlamadan önce

  1. model.sale adresinde oturum açın ve API Anahtarları altında bir API anahtarı oluşturun. Tam gizli anahtar yalnızca bir kez gösterilir.
  2. Faturalama bölümünden bakiye yükleyin veya hesabınız uygunsa tek seferlik Telegram test kredisini kullanın.
  3. GET https://api.model.sale/v1/models adresini açın ve durumu canlı olan bir model seçin. Model kimliğini tahmin etmeyin ve sessizce başka bir model koymayın.
  4. Codex istemcisini kurun, ardından ortam değişkeni yöntemini veya aşağıdaki TOML yapılandırmasını seçin.
Güvenlik kuralı: gerçek bir anahtarı asla bir URL'ye, yükleyici argümanına, Git deposuna, sorun kaydına, ekran görüntüsüne veya paylaşılan bir sohbete yapıştırmayın. Açığa çıkarsa hemen iptal edin ve yenisini oluşturun.

Seçenek A — yerel ortam değişkeni

Codex CLI için en basit kurulumdur ve yerel geliştirmede iyi çalışır. Değer komutun içine gömülmek yerine istemci tarafından çalışma zamanında okunur.

mkdir -p "$HOME/.config/model-sale"
umask 077
read -rsp "Model.sale API key: " MODEL_SALE_API_KEY; echo
printf 'export MODEL_SALE_API_KEY=%q\n' "$MODEL_SALE_API_KEY" > "$HOME/.config/model-sale/env"
chmod 600 "$HOME/.config/model-sale/env"
unset MODEL_SALE_API_KEY
source "$HOME/.config/model-sale/env"

Yeni kabuklarda yüklenmesini istiyorsanız son source satırını ~/.zshrc veya ~/.bashrc dosyasına ekleyin. Ortamı değiştirdikten sonra Codex'i yeniden başlatın.

Seçenek B — Codex özel sağlayıcısı

Codex, ~/.codex/config.toml içinde özel bir sağlayıcıyı destekler. Anahtarı bu dosyanın dışında tutun ve env_key üzerinden referans verin.

[model_providers.model_sale]
name = "Model.sale"
base_url = "https://api.model.sale/v1"
env_key = "MODEL_SALE_API_KEY"
wire_api = "responses"

Zaten bir yapılandırmanız varsa düzenlemeden önce yedekleyin. İstemcide sağlayıcı olarak model_sale seçin ve katalogdan canlı bir model seçin. Tam arayüz etiketi Codex sürümleri arasında farklılık gösterebilir.

Codex uygulaması ve VS Code

  1. Uygulamada veya eklentide sağlayıcı ya da özel endpoint ayarlarını açın.
  2. Base URL'i https://api.model.sale/v1 olarak ayarlayın.
  3. İstemci bir tel protokolü (wire protocol) sorduğunda Responses seçin.
  4. API anahtarı ortam değişkenini MODEL_SALE_API_KEY olarak ayarlayın; gizli anahtarı bir proje dosyasına yapıştırmayın.
  5. Uygulamayı yeniden başlatın veya VS Code penceresini yeniden yükleyin, ardından canlı bir model seçin.

Model.sale standart Responses yolunu /v1/responses üzerinden sunar. İstemci istenen model kimliğini korumalı ve model kullanılamıyorsa bir hata göstermelidir.

Minimal bir istekle doğrulayın

Bunu Codex'in çalışacağı aynı kabuktan çalıştırın. Örnek, gereğinden fazla harcamamak için küçük bir istem kullanır.

Bu örnek şu anda yayımlanmış Responses modelini kullanır: gpt-5.5. Bir istek göndermeden önce hâlâ şurada olduğunu doğrulayın: GET /v1/models

curl https://api.model.sale/v1/responses \
  -H "Authorization: Bearer $MODEL_SALE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","input":"Reply exactly: OK"}'
KontrolBeklenen sonuç
DurumBir Responses JSON nesnesiyle 200.
İstek kimliğix-model-sale-request-id mevcuttur. Destekle iletişime geçerken saklayın.
KullanımGirdi/çıktı kullanımı yanıtta veya Kullanım sayfasında görünür ve ayırma mutabık hale gelir.
BakiyeCüzdan görüntülenen ücret kadar azalır; kullanılmayan ayırma serbest bırakılır.
Akış (streaming)Akış kullanan istemciler için stream: true ayarlayın. Olaylar geldikçe iletilir ve kesin mutabakat için nihai kullanım olayı gereklidir.
Akıl yürütmeYalnızca mevcut model yeteneğinin gösterdiği akıl yürütme düzeyi değerlerini isteyin. Desteklenmeyen değerler gönderimden önce reddedilebilir.
LimitlerAPI anahtarı RPM, TPM, eşzamanlılık ve harcama üst sınırları geçerliliğini korur. Bir limite uymak için istek asla daha ucuz bir modele geçirilmez.

Sorun giderme

BelirtiNeyi kontrol etmeli
401 yetkisizDeğişkenin istemci işleminde yüklü olduğunu, anahtarın ms_live_ ile başladığını ve iptal edilmediğini doğrulayın. Tam anahtarı asla günlüklere yazdırmayın.
402 veya yetersiz bakiyeCüzdana bakiye yükleyin ve kullanılabilir ile geçici olarak ayrılmış bakiyeyi kontrol edin. İlk ayırma nihai kullanımdan sonra serbest bırakılır.
404 model bulunamadı/v1/models listesini yenileyin ve tam canlı model kimliğini kopyalayın. Sağlayıcıya özgü takma adlar eklemeyin.
429 hız veya harcama limitiLimit penceresini bekleyin, paralel istekleri azaltın veya panelde anahtar limitlerini güncelleyin.
İstemcide model yokCodex'i yeniden başlatın, wire_api = "responses" değerini doğrulayın, base URL'de yinelenen /v1 olmadığını kontrol edin ve önce curl isteğini test edin.
Akış erken duruyorBir kez yeniden deneyin, istek kimliğini kaydedin ve Kullanım'ı kontrol edin. Bağlantı kopması tekrar tekrar göndermek için bir neden değildir; yinelenen iş ayrıca ücretlendirilebilir.

Geri alma ve anahtar hijyeni

Geri almak için kayıtlı ~/.codex/config.toml dosyanızı geri yükleyin, ~/.config/model-sale/env dosyasını silin ve kabuk profilinizdeki source satırını kaldırın. Makine paylaşıldıysa veya gizli anahtar kopyalanmış olabilirse anahtarı API Anahtarları'ndan iptal edin.

Model.sale, faturalama ve operasyonlar için gereken istek meta verilerini saklar; istem veya yanıt gövdenizi saklamaz. Kendi istemci günlüklerinizi de aynı özenle tutun: yetkilendirme başlıklarını veya model içeriğini içerebilecek ayrıntılı istek günlüğünü kapatın.

SSS

Bu bir OpenAI API anahtarı mı?

Hayır. Bir Model.sale anahtarı ve Model.sale base URL'i kullanın. Responses tel biçimi Codex istemcileriyle uyumludur, ancak kimlik bilgisi Model.sale hesabınıza aittir.

Herhangi bir model adını kullanabilir miyim?

Yalnızca /v1/models tarafından döndürülen kimlikleri kullanın. Katalog, doğrulama ve erişilebilirlik değiştikçe değişir; kullanılamayan modeller müşteri trafiğine kabul edilmez.

Ne kadar harcadığımı nerede görebilirim?

İstekten sonra Kullanım'ı açın. İstem içeriğini saklamadan endpoint'i, modeli, durumu, token kullanımını, ücreti ve istek kimliğini gösterir.

İlk isteğiniz bir dakikadan kısa sürede.

Bir anahtar oluşturun, 5 $'dan başlayarak bakiye yükleyin ve base URL'i değiştirin. Abonelik yok, gizli ücret yok.

API anahtarını alDokümantasyonu oku