OpenRouter API Üretim Kontrol Listesi

API Uyumluluğunu ve Uç Noktaları Doğrula

Güvenilir entegrasyon için standart OpenAI uyumlu uç noktaları kullanın.

Birincil uç nokta POST /v1/chat/completions. Bu, sohbet geçmişleri için metin oluşturmayı işler. İkincil bir uç nokta, GET /v1/models, mevcut modelleri listeler. Metin odaklı görevler için gömme veya görüntü oluşturma uç noktalarına ihtiyacınız yoktur. Geliştiricilerin çoğu karmaşık bir yönlendirme katmanına ihtiyaç duyduklarını düşünür. OpenRouter bunu tek bir giriş noktası sunarak basitleştirir. Model kimliğinizi ve sistem istemlerinizi içeren bir JSON yükü gönderirsiniz. Hizmet, içerik ve kullanım verileriyle yapılandırılmış JSON döndürür. Bu tasarım resmi OpenAI SDK beklentileriyle eşleşir. İstemci kodunuzu değiştirmeden modeller arasında geçiş yapabilirsiniz. Yapılandırmanızdaki model kimliğini güncellemeniz yeterlidir. İstemcinizin en son JSON şemasını desteklediğinden emin olun. Eski sürümler yeni parametreleri reddedebilir. Üretim ortamına dağıtmadan önce bağlantınızı test edin. Yanıt formatının ayrıştırıcınızla eşleştiğini doğrulayın.

Kimlik Doğrulamayı ve Anahtarları Yapılandırın

API anahtarınızı oluşturulduktan hemen sonra ortam değişkenlerinde güvence altına alın.

Sağlayıcı kontrol paneli aracılığıyla bir anahtar oluşturun. Güvenli bir yerde saklayın. Kaynak deposunda (source repository) asla hardcode etmeyin. Şu şekilde iletin: Authorization: Bearer <key> header. Her anahtar belirli bir hesaba bağlıtır. Sızıntı şüpheleniyorsanız anahtarları değiştirebilirsiniz. Bazı sağlayıcılar hesap başına birden fazla anahtara izin verir. Bu, geliştirme ve üretim trafiğini ayırmanızı sağlar. Anomali tespit etmek için anahtar başına kullanımı izleyin. Kullanılmayan anahtarları düzenli olarak iptal edin. Geçici betikler için kısa ömürlü anahtarlar kullanın. Bu, bir ihlal durumunda etki alanını azaltır. SDK sürümünüzün bearer token kimlik doğrulamasını desteklediğinden emin olun. Eski kütüphaneler farklı bir başlık formatı gerektirebilir. Belirli SDK'nız için belgelere bakın. Anahtarın yeterli bakiyeye sahip olduğunu doğrulayın. Süresi dolmuş bir anahtar 401 hatası döndürür. Bakiyesi sıfır olan bir anahtar 402 hatası döndürür. Mantığınızda bu iki durumu ayırt edin.

Akış ve Token Kullanımını Yönetin

Daha düşük gecikme ve gerçek zamanlı kullanıcı geri bildirimi için akışı etkinleştirin.

Ayarla stream: true istem yükünüzde. Sunucu, bir dizi Sunucu Tarafından Gönderilen Etkinlik (SSE) gönderir. Her etkinlik, kısmi bir metke parçası içerir. Tam yanıtı oluşturmak için bu parçaları birleştirmelisiniz. Son parça genellikle belirteç kullanım istatistiklerini içerir. Bu, maliyetleri gerçek zamanlı olarak izlemenizi sağlar. Akış olmadan, tüm yanıt için beklersiniz. Bu, algılanan gecikmeyi önemli ölçüde artırır. Akış, sohbet arayüzleri için gereklidir. Yanıt veriyormuş gibi hissettiren bir yazma efekti yaratır. Akış sırasında hata yönetimine dikkat edin. Bağlantı koparsa, mevcut parçayı kaybedersiniz. Yeniden bağlanma mantığı, konuşma durumunu korumalıdır. Bazı SDK'lar akışı otomatik olarak işler. Diğerleri manuel olay dinleyicileri gerektirir. Mimarinize uygun yaklaşımı seçin. Ayrıştırıcınızının eksik JSON parçalarını işlediğinden emin olun. Her etkinliğin tam bir nesne olduğunu varsaymayın. Geçerli bir yapıya sahip olana kadar veriyi arabelleğe alın.

Hız Sınırlamalarını ve Eşzamanlılığı İzle

Dakika başına istek sayınızı takip edin, hizmet kesintilerinden kaçının.

OpenRouter her API anahtarı için sıkı hız sınırları uygular. Bu limitleri aşmak 429 Too Many Requests hatasına neden olur. Yenileme mantığınızda üstel geri çekilme (exponential backoff) uygulamanız gerekir. Eşzamanlı istekler de limitlerinizden düşer. Kalan kota için yanıt başlıklarını kontrol edin. Bazı sağlayıcılar bu başlıkları doğrudan ortaya çıkarır. Diğerleri limitleri hatalardan çıkarmanızı gerektirir. Yüksek eşzamanlılık bağlantı havuzunuzu tüketebilir. İstemcinizin bağlantıları verimli bir şekilde yönettiğinden emin olun. Aşırı yükü azaltmak için bağlantı havuzlaması kullanın. Yoğunluk dönemlerinde kuyruk derinliğinizi izleyin. Limite ulaşırsanız, yeniden denemeden önce bekleyin. Bekleme süresini rastgeleleştirerek kalabalık sürü sorunlarını önleyin. Hata ayıklama için tüm hız limiti olaylarını günlüğe kaydedin. Bu, kullanım desenlerinizi belirlemenize yardımcı olur. Bu günlüklere dayanarak eşzamanlılık ayarlarınızı ayarlayın. Tek bir anahtarın sınırsız trafiği yönetebileceğini varsaymayın. Gerekirse yükü birden fazla anahtar arasında dağıtın. Bu dikkatli durum yönetimi gerektirir. Gerekirse her anahtarın kendi bağlamını koruduğundan emin olun.

Kripto Faturalandırma ve Yüklemeleri Yönetin

Aylık ücretler olmadan token kullanımını karşılamak için ön ödemeli kredi kullanın.

Kripto para ile hesabınızı yükleyin. Desteklenen ağlar TRC20 üzerinde USDT ve Base üzerinde USDC'yi içerir. Minimum yüklemeler $20'den başlar. Bonuslar daha büyük miktarlar için uygulanır. $50 için %5 ekstra, $100 için %10 ve $200 için %15 alırsınız. Kredi süresi dolmaz. Bu uzun vadeli projeler için idealdir. Yalnızca kullanılan gerçek token'lar için ödeme yaparsınız. Hatalar ve reddetmeler ücretsizdir. Bu, bütçenizi beklenmedik maliyetlerden korur. Yeni hesaplar test için $0.50 alır. Standart satın alımlar için iade yapılmaz. Çift yüklemeler destek aracılığıyla düzeltilir. Cüzdanınızın gerekli ağları desteklediğinden emin olun. Göndermeden önce sözleşme adresini doğrulayın. Yanlış ağlar fon kaybına neden olabilir. Bakiyenizi düzenli olarak kontrol edin. Düşük bakiyeler hizmeti beklenmedik şekilde kesintiye uğratabilir. Mümkünse yüklemeleri otomatikleştirin. Bu, kritik görevler için sürekli erişilebilirliği sağlar.

İçerik Filtrelerini ve Reddetmeleri Test Edin

Modelin sansürsüz istemlerle beklendiği gibi davrandığını doğrulayın.

Kısıtlanmamış modeller hâlâ katı sınırlamalar uygulayabilir. Belirli içerik türleri için kısıtlamaları kontrol edin. Bilinen tetikleyici ifadelerle test edin. Modelin uygun şekilde yanıt verdiğinden emin olun. Bazı sağlayıcılar yasal nedenlerle filtreleri korur. Modeli hassas veriler için kullanmadan önce bunları doğrulayın. Alanınızdaki uç durumları test edin. Genellikle reddetmeleri tetikleyen prompt'lar gönderin. Yanıt biçimini gözlemleyin. Bir reddetme nedeni döndürüyor mu? Yoksa içeriği sessizce mi üretiyor? Bu davranışları entegrasyon testlerinizde belgeleyin. Bu, üretimde sürprizleri önler. Model davranışını değiştirirse testlerinizi güncelleyin. Önemli herhangi bir kaymayı ekibinize bildirin. Tutarlılık, kullanıcı güveni için anahtardır. Uygulamanızın reddetmeleri zarifçe yönettiğinden emin olun. Her yanıtın geçerli olduğunu varsaymayın. Çıktı yapısını doğrulayın. Halüsinasyonları veya biçimlendirme hatalarını kontrol edin. Bu, güvenilir bir kullanıcı deneyimi sağlar.

Ücretsiz İstekler İçin Hata İşleme Uygula

Sorunsuz bir kullanıcı deneyimi sağlamak için hataları zarifçe yönetin.

Netzwerkfehler, Zeitüberschreitungen und Serverfehler können auftreten. Implementieren Sie Wiederholungslogik mit exponentiellem Backoff. Unterscheiden Sie zwischen vorübergehenden und permanenten Fehlern. Ein 429-Fehler ist vorübergehend. Warten und wiederholen. Ein 400-Fehler ist permanent. Überprüfen Sie Ihre Eingabedaten. Ein 500-Fehler ist serverseitig. Wiederholen Sie mit Vorsicht. Protokollieren Sie alle Fehler zur Fehlersuche. Fügen Sie die Anfrage-Payload und den Antwortkörper hinzu. Dies hilft, Probleme schnell zu reproduzieren. Zeigen Sie Rohfehler nicht direkt an Benutzern an. Formatieren Sie sie in benutzerfreundliche Nachrichten. Behandeln Sie Streaming-Fehler sorgfältig. Trennen Sie die Verbindung zum Ereignis-Stream. Bereinigen Sie Ressourcen. Stellen Sie sicher, dass Ihre Anwendung keinen Speicher verliert. Testen Sie Fehler-Szenarien gründlich. Simulieren Sie Netzwerkunterbrechungen. Simulieren Sie Server-Zeitüberschreitungen. Überprüfen Sie, ob Ihre Wiederherstellungslogik funktioniert. Dies gewährleistet Zuverlässigkeit unter widrigen Bedingungen.

JSON Modu ve Araç Çağırma ile ölçeklendirin

Güvenilir veri çıkarma ve işlev yürütme için yapılandırılmış çıktılar kullanın.

response_format'i json_object olarak ayarlayarak JSON modunu etkinleştirin. response_format: {type: "json_object"}. Bu, modelin geçerli JSON çıktısı vermesini zorlar. Veri ayrıştırmak veya yapılandırma oluşturmak için kullanın. Araç çağırma (tool calling), modelin işlevleri yürütmesine olanak tanır. Araçlarınızı istek yükünde tanımlayın. Model, ne zaman çağıracaklarına karar verir. Sonuçları modele geri iletin. Çıktıya dayalı nihai bir yanıt oluşturabilir. Bu, karmaşık görevler için bir döngü oluşturur. Araç tanımlarınızın net olduğundan emin olun. Belirsiz araçlar hatalı çağrılara yol açar. Ayrıştırmadan önce JSON çıktısını doğrulayın. Bu, kodunuzdaki çalışma zamanı hatalarını önler. Veri çıkarımı görevleri için araç çağırma kullanın. Doğruluğu önemli ölçüde artırır. Çeşitli giriş biçimleriyle test edin. Modelin uç durumları işleyebildiğinden emin olun. Ekibiniz için mevcut araçları belgeleyin. Bu, projeler arasında tutarlı kullanımı sağlar.

Gözden Geçirme Gizlilik ve Veri Kullanım Politikaları

Verilerinizin sağlayıcı tarafından nasıl depolandığını ve kullanıldığını anlayın.

Veri saklama detayları için gizlilik politikasını kontrol edin. Bazı sağlayıcılar verilerinizi eğitim için kullanır. Diğerleri verileri gizli tutar. Verilerinizin model iyileştirmesi için kullanılmadığından emin olun, eğer bu sizin için önemliyse. Şifreleme standartlarını doğrulayın. Veriler hem iletim sırasında hem de saklanırken şifrelenmelidir. Logların kaydedilip kaydedilmediğini kontrol edin. Loglar promptlarınızı içerebilir. Bu logların güvenli olduğundan emin olun. Sorumluluk maddeleri için hizmet şartlarını gözden geçirin. Oluşturulan içeriğin kimin tarafından sahiplendirildiğini anlayın. Bazı sağlayıcılar çıktınız üzerinde hak iddia eder. Bu durumun ihtiyaçlarınızla uyumlu olduğundan emin olun. Artık hizmeti kullanmıyorsanız hesabınızı silin. Verilerinizin kaldırıldığından emin olun. Endişeleriniz varsa destek ekibiyle iletişime geçin. Denetim amaçlı gizlilik ayarlarınızı belgeleyin. Bu, iç politikalara uyumluluğu sağlar.