İlk istek beş dakikada

Temel URL ve Kimlik Doğrulama

API'miz OpenAI v1 arayüzünü yansıtır, bu da uygulama mantığınızı değiştirmeden uç noktaları değiştirmenize olanak tanır. Temel URL olarak https://api.groknsfw.top/v1 kullanın. Kimlik doğrulama, Bearer token olarak Authorization başlığında geçirilen geçerli bir API anahtarı gerektirir. Bu anahtarı panelden Google ile giriş yaparak veya e-posta ile anında oluşturabilirsiniz. Her hesap aynı anda yalnızca bir aktif anahtarı destekler; yeni bir anahtar oluşturmak önceki anahtarı hemen geçersiz kılar. Bu tek anahtar modeli, çoğu geliştirme ve QA ortamı için erişim kontrolünü basitleştirir.

İlk İstek

Bağlantıyı test etmek için standart bir chat completion isteği gönderin. Model tanımlayıcısı uncensored olup, içerik reddetmelerini standart modellerden farklı şekilde işler. Anahtarınızın ve temel URL'nizin doğru olduğunu doğrulamak için curl komut satırı aracını kullanan aşağıdaki temel örneği inceleyin.

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

choices ve usage içeren bir JSON yanlısı alırsanız entegrasyonunuz aktiftir. Doğru faturalandırma takibi için token tüketimini görmek üzere usage nesnesini kontrol edin.

Python SDK Entegrasyonu

Uç noktamızla etkileşim kurmak için resmi openai Python paketini kullanın. Çağrı yapmadan önce base_url ve api_key özniteliklerini ayarlayın. Bu yaklaşım OpenAI şemasını destekleyen herhangi bir kütüphane ile çalışır ve diğer sağlayıcılardan geçişi kolaylaştırır.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.groknsfw.top/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)

Bu kod parçası senkron bir isteği gösterir. Yüksek hacimli NSFW içerik üretimi için ana iş parçacığınızı bloklamadan eşzamanlı istekleri işlemek üzere eşzamansız istemciler kullanmayı değerlendirin.

Node.js SDK Kurulumu

JavaScript veya TypeScript uygulamaları için OpenAI SDK'sını temel URL'mize işaret edecek şekilde yapılandırın. Bu, mevcut istemci kodunuzun değişiklik yapmadan çalışmasını sağlar. Node.js ekosistemi bu uyumluluktan yararlanır ve NSFW sohbet arayüzlerinin hızlı prototiplenmesine olanak tanır.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.groknsfw.top/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Özel temel URL'leri destekleyen SDK'nın güncel bir sürümünü kullandığınızdan emin olun. Yapılandırma nesnesi, uç nokta eşleşme hatalarından kaçınmak için kesinlikle apiKey ve baseURL özelliklerini içermelidir.

Akış Yanıtları (SSE)

İsteklerinizde stream: true ayarlayarak gerçek zamanlı token üretimini etkinleştirin. API, bir Sunucu Tarafı Olayları (SSE) akışı döndürür ve tokenları oluşturuldukları anda iletir. Bu, sohbet uygulamalarındaki son kullanıcılar için algılanan gecikmeyi azaltır.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

delta içeriğini çıkarmak için SSE olaylarını ayrıştırın. Akıştaki son parça, doğru faturalandırma uzlaşımı için kullanmanız gereken toplam usage istatistiklerini içerir. Akış, token sayımı veya fiyatlandırma üzerinde etkili değildir.

Limitler, Hatalar ve Bağlam

İstekleriniz dakikada 300 ve anahtar başına 8 eşzamanlı istek sınırı ile sınırlıdır. Maksimum istek gövdesi boyutu 8 MB'tır ve bağlam penceresi toplamda 100.000 token'a kadar destekler. Hatalar standart HTTP formatlarında döndürülür: geçersiz anahtarlar için 401, yetersiz kredi için 402 ve hız limiti için 429. Kredi hataları ücretsizdir ancak hız limitleri isteklerinizi azaltmanızı gerektirir. İstek başına maksimum çıktı 32.000 token'dır; max_tokens belirtilmezse 2.048 token'a ayarlanır.