API Dokümantasyonu

Temel URL ve Kimlik Doğrulama

API uç noktamız HTTPS://api.aichatuncensored.cc/v1 şeklindedir. Her istekte benzersiz API anahtarınızı Authorization: Bearer <key> header. Bu anahtarı 'API Anahtarı Al' sayfasında Google veya e-posta ile kayıt olduktan hemen sonra alırsınız. Telefon numarası gerekmez ve güvenlik amacıyla anahtar yalnızca bir kez gösterilir.

Copycurl https://api.aichatuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the current UTC timestamp"}]
  }'

Bu temel URL, resmi OpenAI SDK'ları ve herhangi bir uyumlu istemci ile çalışır. Kütüphanenizi adresimize işaret edecek şekilde yapılandırmanız yeterlidir. Yeni bir anahtar herhangi bir zamanda oluşturabilirsiniz; bu, öncekini yerini alır. Her hesap için yalnızca bir aktif anahtarla sınırlıdır.

İlk İstek (cURL ile)

Standart bir kullanarak ilk isteminizi gönderin POST istem /v1/chat/completions. Model tanımlayıcısı uncensored, kısıtlanmamış içerik için ayarlanmış tek bir açık ağırlıklı modeli sunar. Giriş metni messages dizi. Yanıt, oluşturulan metni content alanı.

Copycurl https://api.aichatuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the current UTC timestamp"}]
  }'

Yetersiz kredi nedeniyle dönen hatalar 402 durumunu gösterir. Küçük ilgili içerik için reddetmeler nadirdir ancak mümkündür. Gerçek zamanlı token teslimi için Sunucu Tarafı Olaylar aracılığıyla akış sağlanır. Her istek 8 MB'a kadar gövde verisi destekler.

Python SDK Entegrasyonu

API'mizle etkileşim kurmak için resmi Python kütüphanesini kullanın. Base URL ve API anahtarını istemci yapılandırmasında ayarlayın. Bu, size tanıdık yöntemlerden yararlanma imkanı tanır chat.completions.create. Sözdizimi standart OpenAI uygulamalarını yansıtır.

Copyfrom openai import OpenAI

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

Paketi yükleyin ve istemciyi kimlik bilgilerinizle başlatın. Model adını uncensored kısıtlamasız uç noktamıza ulaştığınızdan emin olmak için. Parametreleri temperature ou top_p yaratıcılığı kontrol etmek için. Yanıt nesnesi, akış yapılıyorsa son parçada kullanım istatistiklerini içerir.

Node.js SDK Kurulumu

Node.js istemcisini kimlik bilgileriniz ve temel URL'nizle başlatın. Bu, sohbet tamamlama uç noktasına doğrudan çağrılara olanak tanır. Kütüphane JSON serileştirmesini ve üst bilgi enjeksiyonunu otomatik olarak yönetir.

Copyimport OpenAI from "openai";

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

Prompt mesajlarınızla completion metodunu çağırın. Yanıt, oluşturulan metni ve token sayılarını içerir. stream bayrağını true olarak ayarlayarak sonuçları akış olarak alabilirsiniz. Hata yönetimi SDK tarafından dahildir. Limitleri yönetmek için 401 veya 429 yanıtları için durum kodunu kontrol edin.

Akış Yanıtları (SSE)

Ayarlayarak akışı etkinleştirin stream: true istekinizde. Sunucu, Sunucu Gönderilen Olaylar olarak veri parçaları gönderir. Her parça kısmi metin ve kullanım meta verileri içerir. Bu, uzun çıktı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 yanıtı birleştirmek için SSE akışını ayrıştırın. Son parça toplam token kullanımını içerir. İhtiyaç duyarsanız akışı erken durdurabilirsiniz. Fonksiyon çağırma ve JSON modu da akış desteği sunar. Bu özellik gerçek zamanlı sohbet arayüzleri için idealdir.

Kotası ve Hata Yönetimi

Her anahtar başına dakikada 300 istekle sınırlısınız. Eşzamanlı istekler anahtar başına 8 ile sınırlandırılmıştır. Bu limitleri aşarsanız 429 durum kodu alırsınız. Kimlik doğrulama hataları 401 hatası döndürür. Yetersiz kredi 402 hatası tetikler.

Bağlam penceresi toplamda 100.000 belirteç destekler. Maksimum çıktı istek başına 16.000 belirteçtir. Ayarla max_tokens beklenmedik maliyetlerden kaçınmak için. Hatalar ve reddetmeler krediden düşmez. Oran limiti yeniden denemeleri için üstel geri çekilme (exponential backoff) kullanın.