TR ▾
Base URL https://api.uncensoredaiapis.com/v1Model uncensored
API anahtarı al
Uncensored AIGeçiş kılavuzu

OpenAI Uyumlu API'yi 5 Adımda Kullanma

OpenAI tarzı bir API kullanmak beş adımdan oluşur: anahtar alın, SDK'yı yükleyin, doğru base URL'ye yönlendirin, bir model adı belirleyin ve mesaj gönderin. İşte kod yapıştırabileceğiniz her biri.

güncellendi

OpenAI tarzı bir API ile başlamak için adımları gösteren bir sunucu küpüne giden beş parlak basamak

Temel noktalar

  • Base URL'yi https://api.uncensoredaiapis.com/v1 olarak değiştirip kendi anahtarınızı kullandıktan sonra herhangi bir OpenAI SDK burada çalışır.
  • Model ID'si uncensored'dur; ana yollar POST /v1/chat/completions ve GET /v1/models'dir.
  • Akış, JSON modu ve fonksiyon çağırma resmi API ile aynı parametreleri kullanır.
  • Fiyatlandırma 1M girdi tokenı başına $0,15 ve 1M çıktı tokenı başına $0,50'dir ve $0,50 deneme kredisi ile başlayabilirsiniz.

Kısa özet

OpenAI olmayan bir hizmetle OpenAI API çağrıları nasıl yapılacağını merak ediyorsanız, yanıt istek formatının ortak bir kural olduğudur. Bunu konuşan bir istemcinin üç değere ihtiyacı vardır: isteklerin gönderileceği yer (base URL), kim olduğunuz (anahtar) ve hangi modelin çalıştırılacağı. Bu üçünü değiştirin ve aynı kod çalışır. Bu site bu kuralı takip eder, bu nedenle standart OpenAI Python ve Node paketleri ve düz curl de buna karşı çalışır.

Bunun ne anlama geldiğini ve ne anlama gelmediğini netleştirin. Uyumlu olması arayüzün eşleştiği anlamına gelir. Resmi OpenAI hizmeti olduğu veya OpenAI modellerini çalıştırdığı anlamına gelmez. Arka uç bağımsız bir sağlayıcı tarafından yürütülen ve yasal yetişkin kullanımı için içerik reddetmeleri olmadan cevap verecek şekilde ayarlanmış bir açık ağırlıklı modeldir ve model ID uncensored ile seçersiniz. Sadece metin işler: resim, ses, gömme veya ince ayar yok.

Aşağıdaki beş adım yaklaşık on dakika sürer. Farklı dillerdeki hazır kod parçacıklarını okumayı tercih ediyorsanız, kod örnekleri sayfasına bakın.

Adım 1: anahtar alın

Google ile veya e-posta ve şifre ile kaydolun ve API anahtarı sayfasını açın. Yeni kullanıcılar tek tıkla $0,50 deneme kredisi talep edebilir. 7 gün boyunca geçerlidir, kişi başı bir kezle sınırlıdır ve kart gerektirmez. Anahtarı kopyalayın ve kodun içine yapıştırmak yerine ortam değişkeni olarak kaydedin:

# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"

Deneme anahtarı dakika başına 60 istek ve 2 eşzamanlı istek ile sınırlıdır. Fonlanmış bir anahtar dakika başına 300 istek ve 8 eşzamanlı istek sağlar. Denemenin içerdiği detaylar ücretsiz deneme SSS sayfasında yer alır.

Adım 2: SDK'yı yükleyin ve ilk isteği gönderin

Diliniz için resmi paketi yükleyin. İkisi de herhangi bir OpenAI tarzı hizmet için kullanacağınız aynı kütüphanelerdir:

# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openai

Şimdi Python ile ilk çağrı. Varsayılan kurulumdan tek fark base_url argümanıdır:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise writing assistant."},
        {"role": "user", "content": "Give me three titles for a noir short story."},
    ],
)
print(resp.choices[0].message.content)

Ve Node'da aynı çağrı:

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);

Adım 3: mesaj dizisini anlayın

Sohbet modelleri çağrılar arasında hiçbir şeyi hatırlamaz. Her istek tüm konuşmayı bir mesaj listesi olarak taşır ve her mesajın bir rolü vardır.

  • system davranışı ve stili belirler. Karakteri, format kurallarını ve kısıtlamaları buraya yazın.
  • user kişinin sorduğu şeyi içerir.
  • assistant modelin önceki yanıtlarını içerir. Bir konuşmaya devam ederken bunları kendiniz eklersiniz.
  • tool bir fonksiyon çağrısının sonucunu taşır, aşağıda açıklanmıştır.

Bir sohbeti devam ettirmek için modelin yanıtını ve bir sonraki kullanıcı mesajını aynı listeye ekleyin ve tümünü tekrar gönderin. Bu nedenle uzun konuşmalar daha pahalıdır: her çağrı tam geçmişi girdi tokenları olarak öder. Pencere toplam 100.000 tokenı (istem ve tamamlama birlikte) tutar, bu yüzden eski dönüşleri kısaltmak bir sohbet uygulaması oluşturmanın normal bir parçasıdır.

Kullanışlı örnekleme alanları geçirilir: temperature, top_p, stop, seed ve frekans ile varlık cezaları. max_tokens isteğe bağlıdır. Yanıt uzunluğunu ve harcamayı sınırlamak istediğinizde ayarlayın.

Adım 4: akış, JSON modu ve araçlar

Akış

stream: true ekleyerek tokenları sunucu tarafından gönderilen olaylar (SSE) olarak alın. Bu, model hâlâ yazarken metnin görünmesini sağladığı için arayüzlerin hızlı hissetmesini sağlar ve kullanım, akışın sonunda raporlanır.

import OpenAI from "openai";

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

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

JSON modu

Kodunuz yanıtı ayrıştırıyorsa response_format: {"type": "json_object"} kullanın. İstenen anahtarları istemde de açıklayın.

curl https://api.uncensoredaiapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [
      {"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
      {"role": "user", "content": "Rate this line: the rain finally stopped."}
    ]
  }'

Araç çağırma

Fonksiyon şemalarıyla bir tools listesi ve isteğe bağlı olarak tool_choice geçirin. Model bir fonksiyon çalıştırmak istediğinde yanıt tool_calls içerir. Fonksiyonu kendi kodunuzda çalıştırın ve çıktıyı role tool ile bir mesaj olarak gönderin. Fonksiyon çağrıları da akış yapar. Bu ajanlar için yapı taşıdır; kullanım durumları sayfası bunun nerede işe yaradığını gösterir.

Adım 5: limitleri, maliyetleri ve hataları bilin

Bir limite aşılması durumunda API HTTP 429 döndürür. Hata kodu dakika başına çok fazla istek için rate_limited ve aynı anda çok fazla istek için concurrency'dir. Geçici bir aşırı yüklenme de Retry-After: 5 başlığıyla birlikte 429 verir. Akış yapan bir istek, akış bitene kadar eşzamanlılık slotunu korur, bu yüzden okumadığınız akışları kapatın. Gövde limiti 8 MB'tır. Her yanıt X-Request-Id ve X-Balance-USD başlıklarını taşır ve ilki destek için alıntılamanız gereken olandır.

Maliyetler basittir. 3.000 girdi tokenı ve 700 çıktı tokenı içeren bir sohbet çağrısı, milyon başına $0.15 ile 3.000 çarpılarak $0.00045, milyon başına $0.50 ile 700 çarpılarak $0.00035 eder; toplamda $0.0008 eder. Böyle bin çağrı $0.80 eder. Başarısız veya reddedilen istekler için ücret alınmaz ve kredi hiç sona ermez. fiyatlandırma sayfası, $50'den itibaren +%5, $100'den itibaren +%10 ve $200'den itibaren +%15 ek bakiye ile $20 ile $500 arasında bakiye yükleme seçeneklerini listeler. Kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile ödeme yapabilirsiniz.

Bunun resmi API'den farkı

Planlama için üç fark önemlidir. Birincisi, model adı: OpenAI model adı yerine uncensored kullanın. İkincisi, kapsam: yalnızca sohbet tamamlamaları ve model listesi alırsınız, bu nedenle resim oluşturma, konuşma, gömme ve ince ayar gibi özellikler burada değildir. Üçüncüsü, davranış: model yasal yetişkin isteklerini reddetmeyecek şekilde ayarlanmıştır, bu nedenle çıktı ağır filtreli bir asistaninkinden farklı olabilir. Bir kural hiç değişmez: reşit olmayanlar içeren cinsel içerik yoktur.

İlk gün için birkaç alışkanlık yardımcı olur. Anahtarı bir ortam değişkeninde tutun, her çağrının X-Request-Id'ını günlüğe kaydedin ve deneme yaparken max_tokens ayarlayın, böylece kaçan bir yanıt planladığınızdan daha fazla harcayamaz. Bir sohbet arayüzü oluştururken yanıtı akış yapın ve geçmiş büyüdükçe eski dönüşleri kısaltın. Çıktıyı ayrıştıran bir boru hattı oluştururken JSON modunu kullanın ve yine de ayrıştırmayı koruyun, çünkü token limitinde kesilen bir yanıt geçerli JSON değildir. Ve programınızın iki parçası API'ye aynı anda çağrı yaptığında, tam bir anahtarın izin verdiği 8 eşzamanlı isteğe sayın.

Test etme maliyetini unutmayın. Kısa istemlerle yapılan birkaç düzine deney, toplamda bir sentten çok daha az maliyetlidir; bu nedenle $0.50'lik deneme kredisi, istek formatını öğrenirken oldukça yeterli gelir.

Mevcut bir uygulamayı taşıyorsanız, geçiş kılavuzu değişiklikleri sırayla gösterir. Burada gönderilen istemler eğitim için kullanılmaz. Çoğu uygulama için geçiş bu sayfanın başındaki üç değer ve bir model adından ibarettir.

Sorular ve cevaplar

Resmi OpenAI SDK'sını kullanmam gerekiyor mu?

Kullanabilirsiniz ve bu en kolay yoldur. Özel base URL desteklediği sürece herhangi bir OpenAI uyumlu istemci veya düz HTTP de çalışır.

Hangi model adını gönderirim?

uncensored gönderin. Base URL https://api.uncensoredaiapis.com/v1.

Bu resmi OpenAI API'si mi?

Hayır. Aynı istek formatını takip eder ancak model bağımsız bir sağlayıcı tarafından yürütülen açık ağırlıklı bir modeldir ve hizmet OpenAI'den bağımsızdır.

Bir istek ne kadar tutar?

Girdi tokenları 1M başına $0,15 ve çıktı tokenları 1M başına $0,50 tutar. 3.000 girdi ve 700 çıktı token içeren bir istek yaklaşık $0,0008 tutar.

Ödemeden önce deneyebilir miyim?

Evet. Kayıttan sonra tek tıkla $0,50 deneme kredisi talep edebilirsiniz. 7 gün boyunca geçerlidir ve kart gerektirmez.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.