API Hızlı Başlangıç

Temel URL ve Kimlik Doğrulama

İstemcinizi temel URL'mize yönlendirin ve anahtarınızı başlıkta iletin. Standart Authorization şemasını kullandığımız için herhangi bir OpenAI SDK'sı veya uyumlu istemci hemen çalışır. Karmaşık OAuth akışlarını yönetmeniz veya onay beklemeniz gerekmez. Google veya e-posta ile kaydolun, anahtarı kopyalayın ve hazırsınız. Uç nokta https://api.aiohnezensur.com/v1 ve aynı Authorization: Bearer YOUR_API_KEY header'ı her istekte kullanın.

İlk İsteğinizi Gönderme

uncensored modeli test etmek için basit bir chat completion çağrısı yapın. Bu istek bir prompt gönderir ve standart kurumsal güvenlik mekanizmaları olmadan bir metin yanıtı alır. OpenAI protokolünü destekleyen herhangi bir aracı kullanabilirsiniz, ancak doğrudan bir curl çağrısı arka planda neler olduğunu tam olarak gösterir. Değiştirin YOUR_API_KEY panelden aldığınız gerçek anahtarla.

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

Yanıt, oluşturulan metni ve token kullanım istatistiklerini içerir. Bir yanıt alırsanız, entegrasyonunuz doğru çalışıyor demektir. Artık daha karmaşık etkileşimler oluşturabilir veya programlı istemcilere geçebilirsiniz.

Python SDK Entegrasyonu

Resmi OpenAI Python paketini API'mizle sorunsuz etkileşim için kullanın. Base URL'yi uç noktamıza ayarlayın ve anahtarınızı API belirteci olarak sağlayın. Bu, HTTP mantığını yeniden yazmadan mevcut kod tabanlarından yararlanmanızı sağlar. Model ID'si uncensored, kısıtlanmamış çıktı için ayarlanmış özel büyük dil modelimizi tetikler.

Copyfrom openai import OpenAI

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

Bu kod parçacığı temel bir mesaj alışverişini gösterir. Mesajlar dizisini sistem promptları veya konuşma geçmişi içerecek şekilde ayarlayabilirsiniz. SDK, serileştirmeyi ve hata ayrıştırmayı sizin için halleder.

Node SDK Entegrasyonu

API'yi Node SDK'sını kullanarak JavaScript veya TypeScript uygulamalarınıza entegre edin. Base URL ve API anahtarını Python örneğinde olduğu gibi yapılandırın. Bu yaklaşım sunucu taraflı işleme veya arka uç mikroservisleri için iyi çalışır. SDK ağ katmanını soyutlar, böylece istemci mantığına odaklanabilirsiniz.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.aiohnezensur.com/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);

Modelin girdinize yanıt verdiğini görmek için bu kodu çalıştırın. İstem içeriğini değiştirerek hızlıca iterasyon yapabilirsiniz. Yanıt yapısı, yığınınızdaki diğer araçlarla uyumluluğu garanti eden standart OpenAI formatını eşleştirir.

Akış Yanıtları

Oluşturulurken belirteçleri almak için akış özelliğini etkinleştirerek algılanan gecikmeyi azaltın. Bu, metni gerçek zamanlı olarak görüntüleyen kullanıcı arayüzleri için kritiktir. Şunu ayarlayın stream parametresi true istekinizde. API, tek bir JSON nesnesi yerine bir dizi Sunucu Tarafından Gönderilen Olay (SSE) gönderir. Her parça, yanıtın kısmi bir delta'sını içerir.

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)

Bu farkları istemci tarafında birleştirerek tam mesajı yeniden oluşturun. Bu yöntem, uzun çıktılar için bile kullanıcıya anlık bir his verir. Son parça toplam belirteç kullanımını içerir, böylece faturalandırmayı doğru bir şekilde yapabilirsiniz.

Saniye Başına İstek Limitleri ve Kısıtlamalar

Üretimdeki istek hatalarını önlemek için teknik limitleri anlayın. Anahtar başına dakikada 300 istek yapmanıza izin verilir ve 8 eşzamanlı isteğiniz olabilir. İstek gövdesi 8 MB'ı aşmamalıdır. Bu limitleri aşarsanız API 429 durum kodunu döndürür. Bu dalgalanmaları zarifçe işlemek için istemcinizde üstel geri çekilme (exponential backoff) uygulamanız gerekir. Bağlam penceresi toplam 100.000 tokendır, iste başına maksimum çıktı 16.000 tokendır. Hatalar ve reddiyeler krediyi tüketmez, bu nedenle güvenle yeniden deneyebilirsiniz. Kimlik doğrulama hataları 401 döndürür ve yetersiz bakiye 402 döndürür.