API Dokümantasyonu & Hızlı Başlangıç

Kimlik Doğrulama & Base URL

API anahtarınızı dashboard'da oluşturun. Standart OpenAI-uyumlu başlıkları kullandığımız için yalnızca base_url ve API_KEY değişkenler. Bu, mevcut SDK entegrasyonlarınızın değişiklik yapmadan çalışmasını sağlar. Google Girişi veya e-posta/şifre ile kaydı destekliyoruz ve anahtarınız oluşturulduğu anda görünür hale gelir.

• Temel URL: https://api.routeropen.cc/v1
• Auth Header: Authorization: Bearer YOUR_API_KEY

Anahtarınızı güvende tutun, çünkü ön ödemeli kredinizi kontrol eder. Her hesapta aynı anda yalnızca bir aktif anahtar bulunur; yeni bir tane oluşturmak, eskisini hemen değiştirir.

İlk İstek

Standart bir kullanarak ilk isteminizi gönderin chat/completions endpoint. Model kimliği basitçe uncensored. Bu hizmet metni alır ve metin döndürür; yasal yetişkin kullanım için içerik filtreleri yoktur.

Copycurl https://api.routeropen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all files in current directory"}]
  }'

Bu istek temel yapıyı gösterir. Parametreleri temperature ou top_p yaratıcılığı kontrol etmek için. Yanıt, şeffaf faturalandırma için token kullanım istatistiklerini içerir.

Python SDK Entegrasyonu

API'mizi entegre etmek için resmi OpenAI Python kütüphanesini kullanın. İstemciyi base URL'imize işaret edin ve API anahtarınızı kullanın. Bu yaklaşım, zaten OpenAI'ye hedefleyen mevcut kod tabanlarıyla sorunsuz çalışır.

Copyfrom openai import OpenAI

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

Kütüphane JSON serileştirmesini ve akışını otomatik olarak yönetir. Gerekirse yeniden deneme mantığını ve zaman aşımını yapılandırabilirsiniz. Uç noktamız standart parametreleri destekler, bu da diğer sağlayıcılardan geçişi kolaylaştırır.

Node SDK Entegrasyonu

JavaScript geliştiricileri için Node SDK minimal değişikliklerle çalışır. Set the baseURL endpoint'imize ve anahtarınızı sağlayın. Bu, mevcut geliştirme iş akışınızı korurken uncensored modellere erişmenizi sağlar.

Copyimport OpenAI from "openai";

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

Node kullanıcıları temiz kod için async/await kalıplarından yararlanabilir. Yanıt yapısı OpenAI standartlarıyla eşleşir, mevcut ayrıştırıcılarla uyumluluk sağlar. Yalnızca iki değişkeni değiştirerek modelleri veya sağlayıcıları değiştirebilirsiniz.

Akış Yanıtları

Ayarlayarak akışı etkinleştirin stream: true istekinizde. Gerçek zamanlı jeton teslimi için Sunucu Tarafından Gönderilen Olaylar (SSE) döndürürüz. Bu, 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)

Son chunk faturalandırma için toplam jeton kullanımını içerir. Streaming, fonksiyon çağırma dahil tüm parametrelerle çalışır. Anlık geri bildirim kritik olan sohbet arayüzleri için kullanın. Hatalar hala SSE olayları olarak döndürülür, bu da hataları zarifçe yönetmenizi sağlar.

Limitler, Hatalar & Bağlam

API'miz 100,000-token bağlam penceresi ve 8MB istek gövdesi sınırı uygular. Anahtar başına dakikada 300 istek yapabilirsiniz. Bu aşildiğinde 429 hız sınırı hatası alırsınız. Kimlik doğrulama hataları 401 döndürür ve yetersiz kredi 402 döndürür.

Hatalar ön ödemeli kredinizi tüketmez. Hatalı bir istek gönderirseniz ücretlendirilmezsiniz. Model, küçük çocukları içeren istekleri reddeder, ancak aksi halde kısıtlamasız içeriğe izin verir. Oran limitlerini etkili bir şekilde yönetmek için hata işlemenizi sağlam tutun.