Claude API Anahtarı: Yaygın Entegrasyon Hataları

Neden temel URL'niz yanlış olabilir

Temel URL'niz, isteklerinizin nereye gideceğini belirler. Standart bir OpenAI uyumlu istemciyi yanlış uç noktaya yönlendirirseniz, sunucu anahtarınızı hemen reddeder. Birçok geliştirici genel proxy'leri asıl sağlayıcının altyapısıyla karıştırır. Bu uyumsuzluk, mantığınız çalışmadan önce kimlik doğrulama hatalarına neden olur.

İstemci yapılandırmanızı dikkatlice kontrol edin. URL'nin doğru etki alanını ve sürüm yolunu içerdiğinden emin olun. Etki alanı adındaki tek bir yazım hatası trafiği bir ölü sona yönlendirir. Her zaman URL'yi sağlayıcının resmi belgelerine karşı doğrulayın. Benzer hizmet yapılarına dayanarak tahmin etmeyin.

• Etki alanının sağlayıcıyla tam olarak eşleştiğini doğrulayın.
• Yolun doğru API sürümünü dahil edin.
• Karmaşık istemleri çalıştırmadan önce bağlantıyı test edin.

Model kimliklerini model adlarıyla karıştırmak

Model kimlikleri API'nin isteğinizi yönlendirmek için kullandığı benzersiz dizgelerdir. Web sitesinde gördüğünüz pazarlama adından genellikle farklıdırlar. Yanlış tanımlayıcı kullanmak 400 Bad Request hatası döndürür. Bu hata token harcar ve hata ayıklama günlüklerini karıştırır.

API referansında sağlanan tam dizgeyi her zaman kullanın. Örneğin, 'Claude Opus' adlı bir modelin kimliği 'claude-3-opus-20240229' olabilir. Boşluklar ve sürüm numaraları önemlidir. İstemci kodunuzdaki sabit kodlanmış dizgeleri kontrol edin. Sağlayıcı yeni bir model sürümü yayınlarsa bunları güncelleyin.

Uncensored API'miz, işleri basit tutmak için 'uncensored' gibi basit bir kimlik kullanır. Bu, birden fazla sürüm dizgesi yönetmenin karmaşıklığından kaçınır. Tek bir kimlik gönderirsiniz ve tek bir tutarlı davranış alırsınız. Dikkate alınacak sürüm kayması yoktur.

Token limitlerini ve bağlam pencerelerini işleme

Token limitleri, tek bir istekte ne kadar verinin sığacağını tanımlar. Bu limitleri aşmak, girdinizi keser veya yanıtı engeller. Bağlam pencereleri hem isteminizi hem de oluşturulan çıktıyı içerir. Her iki tarafın değişimini de dikkate almalısınız.

Token kullanımını yakından izleyin. Girdiniz büyükse maksimum çıktı tokenlerini azaltın. Bu, isteğin sınırlar içinde kalmasını sağlar. Bazı API'ler girdi ve çıktı tokenleri için farklı ücretlendirme yapar. Ölçeklendirmeden önce fiyatlandırma modelini anlayın.

Hizmetimiz, 100.000 tokenlık bir bağlam penceresi sunar. Bu, belgeyi bölmeden geniş belgelerle çalışmanıza olanak tanır. Kullandığınız kadar ödersiniz. Hatalar ön ödemeli kredinizi tüketmez.

Akışlı ve akışsız yanıt formatları

Akış, oluşturulurken küçük parçalar halinde veri gönderir. Akış olmayan mod, herhangi bir şey göndermeden önce tüm yanıtı bekler. Akış, kullanıcılar için algılanan gecikmeyi azaltır. Kodunuzda Sunucu Olayları (SSE) işlemenizi gerektirir.

İsteğinizde 'stream' parametresini true olarak ayarlayın. Sunucu, parçalı JSON nesneleri döndürür. Her parçayı ayrıştırmalı ve belirteçleri birleştirmelisiniz. Bu yaklaşım daha hızlı görünse de istemcinizde karmaşıklık ekler. Akış olmayan (non-streaming) yöntem, toplu işleme için daha basittir.

SSE aracılığıyla akış desteği sağlıyoruz. Token kullanım ayrıntıları son parçada görünür. Bu, maliyetleri gerçek zamanlı olarak takip etmenize olanak tanır. Hızın önemli olduğu sohbet arayüzleri için bu özelliği kullanın.

Fonksiyon çağırma uyumluluk sorunları

Fonksiyon çağırma, modelin kodunuzun yürütebileceği yapılandırılmış veri döndürmesine olanak tanır. Tüm modeller bu özelliği eşit derecede desteklemez. Uyumluluk modelin eğitimi ve API sürümüne bağlıdır. Eşleşmeyen şemalar ayrıştırma hatalarına neden olur.

İşlev şemanızı net bir şekilde tanımlayın. Tanımlar için standart JSON formatını kullanın. Davranışı doğrularken önce basit işlevlerle test edin. Karmaşıklığı kademeli olarak artırın. İstemci kütüphanenizin en son işlev çağırma sözdizimini desteklediğinden emin olun.

Modelimiz fonksiyon çağrısını destekler. Araçlar ve tool_choice parametrelerini iletebilirsiniz. Bu, harici hizmetlerle güvenilir entegrasyon sağlar. JSON modu, çıktının her zaman geçerli JSON olduğunu sağlar. Temel veri çıkarma için ek ayrıştırma gerekmez.

Anahtar başına oran sınırlamalarını anlama

Hız sınırlamaları, belirli bir sürede ne kadar istek gönderebileceğinizi kontrol eder. Bu sınırları aşmak bir 429 hat tetikler. Uygulamanız pencere sıfırlanana kadar duraklar. Farklı anahtarların farklı sınırları olabilir.

Belirli sayılar için sağlayıcınızın belgelerine bakın. Bazı hizmetler dakikada istek sayısını sınırlar. Diğerleri günde token sayısını sınırlar. Eşzamanlılığınızı dikkatlice planlayın. Çok fazla eşzamanlı istek anahtarınızı aşırı yükleyebilir.

Anahtar başına dakikada 300 istek yapmanıza izin veriyoruz. Aynı anda 8 istek çalıştırabilirsiniz. Bu, çoğu otomatik araç için yeterlidir. Hesap başına bir anahtar, net izlenebilirlik sağlar. Daha yüksek bir işlem kapasitesi gerekiyorsa planınızı yükseltin.

401 ve 429 hatalarını hata ayıklama

Bir 401 hatası, API anahtarınızın geçersiz veya süresi dolmuş olduğunu gösterir. Bir 429 hatası, bir hız sınırına ulaştığınızı gösterir. Bunlar en yaygın entegrasyon sorunlarıdır. Bunları düzeltmek kimlik bilgilerinizi ve kullanım kalıplarınızı kontrol etmeyi gerektirir.

401 hataları için anahtarınızı yeniden oluşturun. Ekstra boşluk olmadan doğru kopyalandığından emin olun. Son kullanma tarihlerini kontrol edin. 429 hataları için kodunuzda üstel geri çekilme uygulayın. Kısa bir gecikmeden sonra istekleri yeniden deneyin.

Hizmetimiz net hata mesajları sağlar. Ayrıntılar için yanıt gövdesini kontrol edin. Belirli anahtar sorunları için destek ekibiyle de iletişime geçebilirsiniz. Krediler süresi dolmaz, bu nedenle bakiyeniz limitlere ulaştığınızda bile güvende kalır.

Proxy mi yoksa doğrudan API mi kullanmalı

Bir vekil sunucu istekleri ara bir sunucu üzerinden yönlendirir. Bu, önbelleğe alma veya yük dengeleme sağlayabilir. Doğrudan API çağrıları doğrudan sağlayıcıya gider. Vekil sunucular gecikme ekler ancak çoklu model yönlendirmesini basitleştirebilir.

Birden fazla modeli birleştirmeniz gerekiyorsa bir proxy kullanın. Tek model kullanımları için doğrudan çağrılar daha hızlı ve daha ucuzdur. Proxy'ler genellikle fiyatlandırmaya kendi kar paylarını ekler. Takasları dikkatlice değerlendirin.

API'miz doğrudan bir servistir. Uç noktamıza doğrudan bağlanırsınız. Bir ara katman karmaşıklık veya maliyet eklemez. Tahmin edilebilir fiyatlandırma ve performans elde edersiniz. Bu, sadeliği tercih eden geliştiriciler için idealdir.