Kurulum ve yapılandırma
İstemcinin, istekleri sunucularımıza yönlendirmek için yalnızca API anahtarınıza ve doğru base URL'ye ihtiyacı vardır. Bu kurulum, herhangi bir standart OpenAI-uyumlu istemciyle çalışır.
Ortam değişkenlerini yapılandırın veya bunları istemci yapıcısına doğrudan geçirin. Karmaşık yönlendirme mantığını yönetmenize veya birden fazla model arasında geçiş yapmanıza gerek yoktur. Tek uncensored model tüm istekleri yönetir.
- Paketi paket yöneticiniz aracılığıyla yükleyin.
- API anahtarını kontrol panelinizden alın.
- İstemciyi API uç noktasına yönlendirin.
İlk isteğinizi yapmak
Model kimliğini "uncensored" olarak ayarlayarak sohbet tamamlama uç noktasına bir POST isteği gönderin. Bu, standart içerik filtrelerini atlayarak modelden doğrudan bir metin yanıtı döndürür. Basit istemler veya karmaşık sistem talimatları gönderebilirsiniz.
API, sıcaklık ve top_p gibi standart parametreleri kabul eder. Bağlantıyı ve yanıt kalitesini hemen doğrulamak için aşağıdaki cURL komutunu kullanın.
curl https://api.chatbotunrestricted.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fetch current temperature in Tokyo."}]
}'Bu yanıt, modelin aktif olduğunu ve üretim trafiğine hazır olduğunu onaylar.
Akış yanıtlarını işleme
Akış özelliğini etkinleştirin ve stream parametresini true olarak ayarlayın. API, tokenları oluşturuldukları gibi teslim eden bir Sunucu Tarafından Olaylar (SSE) akışı döndürür. Bu, son kullanıcılar için algılanan gecikmeyi önemli ölçüde azaltır.
Arayüzünüzü gerçek zamanlı güncellemek için SSE parçalarını ayrıştırın. Son parça, istek için toplam token kullanımını içerir. Bu yaklaşım, kullanıcıların anında geri bildirim beklediği sohbet arayüzleri için esastır.
stream = 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)İstemciniz akış sonlandırma olayını doğru şekilde işlediğinden emin olun.
Araçlar ve fonksiyon çağırma kullanımı
Modelin yapılandırılmış işlev çağrıları üretmesini sağlamak için istek gövnenize araçlar tanımlayın. Araç tanımlamalarını tools dizisinde iletin ve otomatik seçim için tool_choice'u belirtin. Model, yanıt içeriğinde işlev çağrıları döndürür.
Fonksiyon argümanlarını ayrıştırın ve kodunuzda çalıştırın. Ardından, sonuçları bir sonraki mesajda modele iletin. Bu döngü, harici ayrıştırma mantığı olmadan karmaşık çok adımlı iş akışlarına olanak tanır.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.chatbotunrestricted.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);Yürütmeden önce çıktı şemasını her doğrulayın.
Token'ları ve limitleri yönetme
Bağlam penceresi, hem istem hem de tamamlama için birlikte 100.000 jetonu destekler. Her istek 16.000 jetona kadar çıktı verebilir veya max_tokens belirtilmediğinde 2.048 jeton. Kullanımınızı yanıt içindeki jeton sayımları aracılığıyla izleyin.
Hız limitleri dakikada 300 istek ve anahtar başına 8 eşzamanlı istek sağlar. Bu limitlerin aşılması bir 429 hatası tetikler. Limitleri paylaşmamak için anahtarınızı her hesap için benzersiz tutun.
401 geçersiz bir anahtarı, 402 ise daha fazla kredi ihtiyacınızı gösterir. Küçük içerik ihlalleri nedeniyle gerçekleşen reddetmeler ücretsizdir ve tokenları tüketmez.
Hata yönetimi ve sorun giderme
Uygulama mantığınızda HTTP hatalarını zarifçe yönetin. 401 durumu, API anahtarınızın yanlış veya süresi geçmiş olduğunu gösterir. Anahtarın aktif olduğundan emin olmak için kontrol panelinizi kontrol edin.
402 durumu, yetersiz ön ödemeli bakiye gösterir. Hizmeti devam ettirmek için USDT veya USDC ile bakiye yükleyin. 429 hatası, hız sınırına ulaştığınızı gösterir. Bekleyin ve üstel geri çekilme ile yeniden deneyin.
Geçersiz istek gövdeleri 400 hatası döndürür. JSON yapınızın API spesifikasyonuyla eşleştiğinden emin olun. Bu hatalar ücretsizdir ve bakiyenizden düşülmez.
Python
from openai import OpenAI
client = OpenAI(base_url="https://api.chatbotunrestricted.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)