API Dokümantasyonu: 5 Dakikada Hızlı Entegrasyon

Ortam Yapılandırması ve Kimlik Doğrulama

Başlamak için panonuzdan benzersiz API anahtarınızı almanız gerekir. Bu anahtar, isteklerinizi kimlik doğrulamak için kullanılacaktır. Genel modellerin aksine, API'miz standart bir uç noktaya dayanır ve resmi SDK'ları veya herhangi bir OpenAI uyumlu istemciyi kullanmanızı sağlar. Başlangıç deneme kredisine erişmek için telefon numarası veya kredi kartı sağlamanıza gerek yoktur.

Temel uç nokta https://api.llmnoncensure.com/v1 şeklindedir. Ortamınızı bu özel base URL'yi kullanacak şekilde yapılandırdığınızdan emin olun. API anahtarı Authorization: Bearer <YOUR_API_KEY> üst bilgisi aracılığıyla iletilmelidir. Hesap başına bir anahtar oluşturulur; istediğiniz zaman yeni bir tane oluşturabilirsiniz, bu eski anahtarı otomatik olarak geçersiz kılar.

İlk cURL İsteği

Entegrasyonun çalıştığını doğrulamak için ilk isteğinizi gönderin. uncensored model kimliğini kullanıyoruz. Bu istek, girdi olarak bir metne sahip olur ve küçüklerle ilgili cinsel içerik değilse, genellikle bulunan içerik filtreleri olmadan metinsel bir yanıt alırsınız. Model, haksız yere reddetmeden yetişkin, tartışmalı veya güvenlik araştırmaları konularına yanıt verecek şekilde ince ayarlanmıştır.

Bağlantıyı test etmek için temel yapı aşağıdadır :

Copiercurl https://api.llmnoncensure.com/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."}]
  }'

Bu komut, anahtarınızın aktif olduğunu ve modelin karmaşık istemleri almaya hazır olduğunu doğrular.

Python SDK ile Entegrasyon

Python geliştiriyorsanız, sorunsuz entegrasyon için openai kitaplığını kullanın. OPENAI_BASE_URL ortam değişkenini ayarlayın veya istemciye doğrudan base_url parametresini geçirin. Bu, model kaynağını basitçe değiştirerek mevcut kodunuzu yeniden kullanmanızı sağlar. SDK, JSON serileştirmesini ve ağ hatalarını sizin için yönetir.

İşte bir minimum örnek:

Copierfrom openai import OpenAI

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

uncensored modeli, temperature ve max_tokens gibi standart parametreleri kabul eder. Yanıtın yaratıcılığını, yapay zekanın genel kriterlere göre "riskli" bulduğu bir yanıtı engellemekten korkmadan ayarlayabilirsiniz.

Node.js ve JavaScript ile Kullanım

JavaScript veya TypeScript ortamları için openai SDK'sı aynı şekilde çalışır. İstemciyi temel URL ve API anahtarı ile yapılandırın. Bu yaklaşım, genel büyük sağlayıcıların sınırlamaları olmadan dinamik AI yanıtları entegre etmesi gereken arka uç uygulamaları veya API sunucuları için idealdir.

Copierimport OpenAI from "openai";

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

Asenkron yanıtları doğru şekilde yönettiğinizden emin olun. Her istek ayrı ayrı işlenir; bu, iş mantığınızın modelin üretim gecikmeleri tarafından engellenmemesini sağlar. 100.000 token'lık bağlam penceresi, uzun sistem istemlerini veya geniş konuşma geçmişlerini göndermenize olanak tanır.

SSE Akış Desteği

Akıcı bir kullanıcı deneyimi için sunucu gönderilen olaylar (SSE) üzerinden akışı etkinleştirin. Bu, oluşturmanın bitmesini beklemek yerine yanıtın kelimeleri kelimelere görüntülenmesini sağlar. Bu, algılanan gecikmenin kritik olduğu sohbet arayüzleri için özellikle yararlıdır. Veri akışı, istemci tarafı ayrıştırmayı kolaylaştıran OpenAI standardına göre yapılandırılmıştır.

Copierstream = 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)

Akış, model mantığını değiştirmez; yalnızca veri iletimini değiştirir. Her parça, nihai yanıtın bir parçasıdır. Kullanıcı istemi değiştirirse akışı istediğiniz zaman durdurabilirsiniz, bu da kredilerinizin kullanımını optimize eder.

Hız Limitleri, Hatalar ve Bağlam

API sınırlarınızı bilmek sağlam bir entegrasyon için kritik öneme sahiptir. Her API anahtarı başına dakikada 300 istekle sınırlı olursunuz. İstek gövdesi 8 MB'ı geçmemelidir. Hata durumunda standart HTTP kodları döndürülür: 401 geçersiz bir anahtar için, 402 krediniz tükendiğinde ve 429 istek hız limitini aştığınızda. Model, istem ve yanıtı birleştiren 100.000 token'lık bir bağlam penceresine sahiptir. Bu, erken kesilme olmadan uzun belgeler veya kapsamlı konuşmalar göndermenizi sağlar. Diğer hizmetlerin aksine, sabit aylık ücret yoktur; yalnızca ön ödemeli kredilerinizle tükettiğiniz kadar ödersiniz.