Sansürsüz Gemma: Geliştiriciler İçin Entegrasyon Kılavuzu

Neden Sansürsüz Gemma'yı Seçmelisiniz?

Geliştiriciler sansürsüz gemma tarzı bir deneyim aradığında, genellikle ticari ürünlerde yaygın olan güvenlik filtrelerinden kaçınan bir model aramaktadırlar. Bu API, yasal yetişkin kullanımı, güvenlik araştırmaları veya tartışmalı konular için içerik reddi olmadan yanıtlamak üzere ayarlanmış tek, yüksek kapasiteli bir model sunar. Birden fazla sağlayıcıyı birleştiren platformların aksine, bu hizmet tutarlı davranış ve öngörülebilir gecikme süresi sağlamak için tek bir belirli açık ağırlıklı modele odaklanır.

Model, standart yaratıcı veya analitik istemleri reddetmez; bu da onu çeşitli içerik stilleri oluşturmaya uygun kılar. Ancak, bağımsız bir açık ağırlıklı model olduğu, Google'ın Gemma'sı olmadığı ve xAI'nin Grok'ı ile ilişkili olmadığı önemlidir. Özel sunucularda çalışır ve metin girdisi ile metin çıktısı sağlar; çoklu model yönlendirmesinin yükü olmadan ham model çıktısına ihtiyaç duyan geliştiriciler için temiz, öngörülebilir bir ortam sunar.

API Uyumluluğu Genel Bakış

API tamamen OpenAI uyumludur; bu nedenle resmi OpenAI SDK'larını veya OpenAI protokolünü konuşan herhangi bir başka istemciyi kullanabilirsiniz. Yalnızca base_url değerini güncellemeniz ve API anahtarınızı sağlamanız yeterlidir. Uç nokta yapısı standart sohbet tamamlama arayüzünü yansıtır; bu da diğer sağlayıcılardan geçişi basitleştirir.

• Uç Noktalar: Yalnızca POST /v1/chat/completions ve GET /v1/models mevcuttur.
• Ekstra Özellik Yok: Gömme (embeddings), görüntü oluşturma, ses işleme veya ince ayar uç noktaları yoktur.
• Temel URL: https://api.grokuncensored.cc/v1
• Model Kimliği: Model tanımlayıcısı olarak uncensored kullanın.

Bu sadelik, entegrasyon karmaşıklığını azaltır. Farklı özellikler için farklı yanıt şemalarını yönetmenize gerek yoktur. Yanıt formatı tutarlıdır; metin içeriğini ve token kullanım istatistiklerini döndürür.

Çevrenizi Hazırlama

Entegrasyon, bir API anahtarı elde etmeyle başlar. Google kimlik doğrulaması veya e-posta ve şifre kullanarak API anahtarı al sayfası aracılığıyla kaydolun. Anahtar hemen görüntülenir ve telefon numarası gerekmez. Bu süreç hız için tasarlanmıştır; dakikalar içinde testlere başlayabilirsiniz.

Anahtarınızı aldıktan sonra ortam değişkenlerinizi yapılandırın. Örneğin, Python'da:

Temel URL'nizin https://api.grokuncensored.cc/v1 adresini işaret ettiğinden emin olun. Ayrıca, kredi kartı gerekmeden 7 gün boyunca geçerli olan 0,50 $ deneme kredisi avantajını da kullanabilirsiniz. Bu, kripto para birimi yüklemesine geçmeden önce bağlantıyı ve yanıt kalitesini doğrulamanızı sağlar.

İlk İsteğinizi Gönderme

Çevreniz yapılandırıldığında bir istek gönderebilirsiniz. API standart mesaj dizilerini kabul eder. İşte cURL kullanan temel bir örnek:

Copycurl https://api.grokuncensored.cc/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."}]
  }'

Yanıt oluşturulan metni ve token kullanımını içerecektir. max_tokens değerini ayarlarsanız API bu sınırı dikkate alacaktır. max_tokens ayarlamazsanız varsayılan maksimum çıktı 2.048 token'dır. Daha uzun çıktılar için, toplam bağlam (istem + tamamlama) 100.000 token penceresi içinde kaldığı sürece bunu 32.000 token'a kadar artırabilirsiniz.

Yanıtları ve Token'ları Yönetme

Yanıtlar standart JSON formatında döndürülür. Token kullanımı, akış yanıtının son parçasında dahil edilir; bu da maliyetleri gerçek zamanlı izlemenizi sağlar. Fiyatlandırma şeffaftır: 1M giriş token'ı başına 0,25 $ ve 1M çıktı token'ı başına 1,00 $. Hatalar ve reddetmeler ücretsizdir; bu nedenle harcanan kredi endişesi olmadan deneyebilirsiniz.

Akış kullanırken istemcinizin Sunucu Tarafından Gönderilen Olayları (SSE) doğru şekilde işlediğinden emin olun. API metin parçaları döndürür ve son parça usage alanını içerir. Bu, hassas faturalama uzlaştırmasına olanak tanır. Kredi ön ödemelidir ve hatalar bakiyenizden düşmez. Bu model bir gömme hizmeti değildir; bu nedenle vektör aramaları için doğrudan kullanamazsınız; gerekirse gömmeleri ayrı olarak yönetmeniz gerekir.

Gelişmiş Parametreler

API, üretim kalitesini kontrol etmek için çeşitli parametreler destekler. Yaratıcılık için temperature, nükleus örnekleme için top_p ve üretilenliği sağlamak için seed değerlerini ayarlayabilirsiniz. Diğer desteklenen parametreler stop, presence_penalty ve frequency_penalty'i içerir.

Fonksiyon çağırma, tools ve tool_choice alanları aracılığıyla desteklenir. Bu, modelin uygulamanız tarafından ayrıştırılabilecek yapılandırılmış çıktılar oluşturmasını sağlar. Ayrıca, çıktının geçerli JSON olduğundan emin olması için JSON modu response_format: {"type": "json_object"} aracılığıyla mevcuttur. Bu, ajanlar veya yapılandırılmış veri boru hatları oluşturmak için kullanışlıdır. Model, yüksek kaliteli metin üretimi için ayarlanmış bir açık ağırlıklı modeldir; bu da onu karmaşık talimatları izleme için uygun kılar.

Hata Yönetimi

Hatalar standart HTTP durum kodlarında döndürülür. Yaygın hatalar arasında hız limiti (429) veya geçersiz API anahtarları (401) bulunur. Hız limitleri dakikada 300 istek ve ana başına 8 eşzamanlı istek olarak ayarlanmıştır. Bu limitlere ulaşırsanız istemcinizde üstel geri çekilme uygulayın.

İstek gövdesi 8 MB ile sınırlıdır. Bu değeri aşarsanız istek reddedilir. İstemlerinizin bu sınırlar içinde olduğundan emin olun. API yalnızca metin tabanlı olduğu için medya işleme ile ilgili hatalar oluşmaz. Fatura hataları (yetersiz kredi gibi) durumunda API 402 durum kodu döndürür. Kredi süresi hiç dolmaz, bu nedenle bakiye yüklemeyi istediğiniz zaman yapabilirsiniz. Çift ücretlendirme gibi hatalar Destek sayfası üzerinden çözülebilir; kredi otomatik olarak iade edilmez.

Grok Sansürsüz ile Karşılaştırma

Sıklıkla grok sansürsüz gibi diğer sansürsüz modellerle birlikte tartışlsa da bu API bağımsız bir hizmettir. Google'ın Gemma'sını sunmaz ve xAI'nin resmi Grok API'si değildir. Arama sonuçlarındaki sansürsüz gemma terimi genellikle açık ağırlıklı modelin davranışını ifade eder; bu API bunu yakından taklit eder. Ancak model kimliği yalnızca uncensored'dir ve Google mimarisine bağlı değildir.

Farklı fiyatlandırma ve limitlere sahip olabilecek resmi Grok API'nin aksine, bu API milyon token başına sabit $0.25/$1.00 fiyatı sunar. Ayrıca deneme için kredi kartı gerekmeden yalnızca kripto para ödemelerini destekler. Bu, kripto kullanmayı tercih eden veya abonelik kilitlemelerinden kaçınmak isteyen geliştiriciler için esnek bir alternatiftir. Model, Grok'un bir satıcısı değildir; açık ağırlıklı ayrı bir modeldir.

Sonuç

Bu API, sansürsüz bir açık ağırlıklı model için sağlam, geliştirici odaklı bir arayüz sağlar. OpenAI uyumlu protokole bağlı kalarak mevcut iş akışlarına sorunsuz entegre olur. Fiyatlandırma şeffaftır ve limitler çoğu kullanım durumu için cömerttir. İster sohbet botu, ister ajan, ister içerik üretim aracı geliştiriyor olun, bu API güvenilir, sansürsüz bir alternatif sunar. Yalnızca metin tabanlı bir API olduğunu unutmayın; mimarinizi buna göre planlayın. Fiyatlandırma ve anahtarlar hakkında daha fazla ayrıntı için sitedeki ilgili sayfaları ziyaret edin.