Geliştiriciler için Codex API Anahtarı Açıklaması

API Anahtarı Biçimini Anlamak

Bir codex api key sağlayan bir hizmete giriş yaptığınızda, benzersiz bir alfanümerik dize alırsınız. Bu anahtar, arka uca gönderilen her istek için kimlik doğrulama kimlik bilgileriniz olarak işlev görür. Format genellikle sağlayıcının uygulamasına bağlı olarak sk-... veya benzeri önekler gibi standart bir deseni izler. Ancak bağımsız bir proxy kullandığınız için kesin önek değişebilir. Kritik olan nokta, formatın kendisi değil, anahtarın HTTP Authorization başlığında Bearer <your_key> olarak doğru şekilde iletilmesidir.

API anahtarınız belirli bir hesap ve kullanım katmanıyla ilişkilidir. Farklı ortamlar için (dev vs. prod) birden fazla anahtar oluşturan bazı hizmetlerin aksine, kurulumumuz basittir: bir hesap, bir anahtar. Anahtarınızı kaybederseniz veya güvenliğinin ihlal edildiğinden şüphelenirseniz, onu panelden hemen yeniden oluşturabilirsiniz. Bu, eski anahtarı anında geçersiz kılar ve yetkisiz erişimin devam etmesini önler. Anahtarları her değiştirdiğinizde ortam değişkenlerinizi veya yapılandırma dosyalarınızı güncellemeyi unutmayın.

Güvenlik En İyi Uygulamaları

• Anahtarınızı kaynak kodunuzda değil, ortam değişkenlerinde saklayın.
• codex api key anahtarınızı genel depolama alanlarına (repository) kaydetmeyin.
• Maruz kalmadan şüpheleniyorsanız yeniden oluşturma işlevini kullanın.

Yaygın Hata: 401 Yetkisiz

401 Yetkisiz hatası, yeni bir API anahtarı entegre ederken en yaygın sorundur. Sunucunun kimlik doğrulama kimlik bilgilerinizi reddettiğini gösterir. Bir claude code proxy veya herhangi bir OpenAI uyumlu uç nokta bağlamında, bu neredeyse her zaman anahtarın eksik, yanlış veya süresi dolmuş olduğu anlamına gelir.

Sorun giderme için önce anahtarı sağlandığı şekilde kopyaladığınızdan emin olun. Anahtarlar genellikle büyük/küçük harfe duyarlıdır ve yanlış kopyalanırsa boşluk içerebilir. Bölgeniz veya hizmet katmanınız için doğru temel URL'yi kullandığınızdan emin olun. Anahtarınızı yakın zamanda yenilediyseniz, istemcinizin yeni değeri kullandığından emin olun. 401 hatası kullanım bakiyeniz veya hız limitlerinizle ilgili değildir; bu tamamen bir kimlik doğrulama hatasıdır.

Çözüm Kontrol Listesi

1. API anahtarı dizesinin paneldakiyle tam olarak eşleştiğini onaylayın.
2. Authorization başlık biçimini doğrulayın: Authorization: Bearer YOUR_KEY.
3. Temel URL'nin hesap türünüz için doğru olduğunu kontrol edin.
4. Kopyala-yapıştır sırasında ekstra boşluk eklenmediğinden emin olun.

Hız Limiti Aşıldı: 429 Hataları

İzin verilen istek hacmini aştığınızda API, 429 Too Many Requests hatasını döndürür. Hizmetimiz için sınır, anahtar başına dakikada 300 istek olarak ayarlanmıştır. Bu sınır, adil kullanım sağlamak ve tüm kullanıcılar için düşük gecikme süresini korumak için uygulanır. Yüksek hacimli kodlama oturumları çalıştırıyorsanız, özellikle kodunuz birden fazla dahili istek tetiklediğinde bu sınırı hızla aşabilirsiniz.

Bir 429 hatası oluştuğunda, yanıt genellikle yeniden denemeden önce kaç saniye beklemeniz gerektiğini gösteren bir Retry-After başlığı içerir. İstemci kodunuzda üstel geri çekilme uygulamak, bu hataları zarifçe yönetmenin standart yoludur. Hemen yeniden denemek yerine, kısa bir süre bekleyin ve sonraki yeniden denemeler için bekleme süresini iki katına çıkarın. Bu, sınır sıfırlanırken uygulamanızın sunucuyu isteklerle doldurmasını önler.

Hız limitlerinin hesap başına değil, ana başına uygulandığını belirtmek önemlidir. Aynı anahtarı kullanan birden fazla cihaz veya işleminiz varsa, dakikada 300 istek bütçesini paylaşırlar. Daha yüksek toplam verimlilik gerekiyorsa farklı ortamlar için ayrı anahtarlar kullanmayı düşünün.

Temel URL'nin Doğru Yapılandırılması

Temel URL, herhangi bir API entegrasyonunun temelidir. OpenAI uyumlu bir hizmet için temel URL, isteklerinizin nereye gönderileceğini belirler. Temel URL'miz https://api.claudecodeapikey.com/v1 şeklindedir. Bu URL, herhangi istek yapmadan önce istemci kitaplığınızda veya SDK'nızda yapılandırılmalıdır. Yanlış temel URL kullanırsanız bağlantı hataları veya beklenmeyen yanıtlar alırsınız.

Birçok geliştirici Python, Node.js veya diğer diller için resmi OpenAI SDK'sını kullanır. Proxy'mize geçmek için temel URL yapılandırmasını basitçe güncellemeniz yeterlidir. Örneğin, Python'da base_url='https://api.claudecodeapikey.com/v1' olarak ayarlayabilirsiniz. Protokolün (https) ve yolun (/v1) doğru olduğundan emin olun. /v1 yolunu atlamak, 404 hatalarına yol açan yaygın bir hatadır.

İstemcinizin doğru uç noktaya istek gönderdiğini her zaman doğrulayın. Bunu ağ günlüklerinizi kontrol ederek veya bağlantıyı test etmek için curl gibi bir araç kullanarak yapabilirsiniz. Temel URL'ye başarılı bir bağlantı, yapılandırmanızın doğru olduğunu doğrular.

Akış Yanıtlarının Yönetimi

Akış yanıtları, tüm yanıt tamamlanmasını beklemek yerine, API yanıtının parçalarını oluşturulurken almanızı sağlar. Bu, kod parçalarını gerçek zamanlı olarak görüntüleyen kodlama ajanları için kritiktir. API'miz Sunucu Gönderilen Olaylar (SSE) üzerinden akış desteği sunar. İstemcinizde akışı etkinleştirdiğinizde, her biri kısmi yanıt içeren bir parça akışı alırsınız.

Akışı etkinleştirmek için isteğinizde stream parametresini true olarak ayarlayın. İstemci kitaplığı SSE protokolünü otomatik olarak yönetecektir. Her parça geldiğinde onu işleyebilir, UI'nizi güncelleyebilir veya ilerlemeyi günlüğe kaydedebilirsiniz. Bu, özellikle uzun kod üretimleri için daha iyi bir kullanıcı deneyimi sağlar.

Akış, temel modeli veya yeteneklerini değiştirmez. Saf bir taşıma mekanizmasıdır. Model hala tüm isteği işler ve tam yanıtı oluşturur; fark, çıktının istemcinize nasıl sunulduğudur.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.claudecodeapikey.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Tool Çağırma Yapılandırma Sorunları

Tool çağırma (veya fonksiyon çağırma), LLM'in belirli eylemleri (örneğin bir kod parçası çalıştırmak veya veritabanı sorgulamak) talep etmesine olanak tanır. API'miz tool çağırma destekler, yani isteğinizde fonksiyonları tanımlayabilir ve modelden yapılandırılmış JSON yanıtları alabilirsiniz. Bu, harici sistemlerle etkileşim kurması gereken gelişmiş kodlama ajanları için gereklidir.

Araç çağırma yapılandırmak için tools parametresinde bir fonksiyon tanımı listesi sağlamanız gerekir. Her araç bir ad, açıklama ve parametre şemasına sahip olmalıdır. Model, isteme dayanarak ne zaman bir araç çağıracak olduğuna karar verecektir. Model bir araç çağırmaya karar verirse, yanıt fonksiyon adını ve argümanları içeren bir tool_calls dizisi içerecektir.

Yaygın sorunlar yanlış JSON şema tanımlarından kaynaklanır. Parametre türlerinizin ve gerekli alanlarınızın doğru şekilde belirtildiğinden emin olun. Şema geçersizse model aracı doğru şekilde çağırmayabilir. Modelin beklenen davranışı anladığını doğrulamak için basit istemlerle tool tanımlarınızı test edin.

Bağlam Penceresi Sınırları

Bağlam penceresi, modelin tek bir istekte işleyebileceği maksimum metik miktarını tanımlar; hem istemi (girdi) hem de tamamlamayı (çıktı) içerir. Modelimizin 100.000 token'lık bir bağlam penceresi vardır. Bu önemli miktarda metiktir ancak sonsuz değildir. İstem plus beklenen çıktı bu sınırı aşarsa API bir hata döndürür.

Bağlamı verimli yönetmek için istemlerinizin token kullanımını izleyin. Uzun dosyalar veya kapsamlı konuşma geçmişleri mevcut tokenları hızla tüketebilir. Sınıra yaklaşırsanız, eski mesajları kısaltmayı veya önceki etkileşimleri özetlemeyi düşünün. Bazı istemciler pencereyi kaydırarak bunu otomatik olarak yönetse de, beklenmedik hatalardan kaçınmak için sınırı bilmek en iyisidir.

Bağlam penceresinin sistem mesajları, kullanıcı mesajları ve asistan mesajları dahil modelin tüm gönderdiği tokenları içerdiğini unutmayın. Uzun kodlama oturumları sırasında sorunsuz çalışma sağlamak için token bütçenizi buna göre planlayın.

Anahtarınızı Yeniden Oluşturma

API anahtarınızı yenilemek güvenliği sağlayan basit bir işlemdir. Anahtarınızın açığa çıktığından şüpheleniyorsanız veya kimlik bilgilerini düzenli olarak değiştirmek istiyorsanız, panelden yeni bir anahtar oluşturabilirsiniz. Eski anahtar hemen geçersiz kılınır, bu nedenle eski anahtarı kullanan devam eden istekler başarısız olur.

Bir anahtarı yenilediğinizde, tüm istemcilerinizi ve yapılandırmalarınızı yeni değerle güncellediğinizden emin olun. Bu işlem ortam değişkenlerini, yapılandırma dosyalarını ve kodunuzdaki sabit değerleri içerir. Tüm konumları güncellememeniz, uygulamanızın bazı bölümlerinde kimlik doğrulama hatalarına yol açabilir.

Hizmetimiz sınırsız anahtar yenilemeye olanak tanır. Anahtarınızı sık sık değiştirmek için bir ceza yoktur. Bu, özellikle paylaşılan ortamlarda veya anahtarları ekip üyelerine dağıtırken güvenliği korumak için iyi bir uygulamadır.

Copycurl https://api.claudecodeapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'