Unzensierte API Dokümantasyonu

Hızlı Başlangıç: ilk isteğinizi gönderin

The Venice AI API, OpenAI-uyumlu bir hizmettir. Metin üretimi için token başına ödeme yaparsınız ve içerik filtreleri yoktur. API anahtarınızı kullanarak POST isteğini chat completions uç noktasına gönderin. Model, prompt'unuzu işler ve metin çıktısını doğrudan döndürür.

Anahtarınızla kimlik doğrulaması yapın. Ardından model ID'sini "uncensored" olarak belirleyin. Rol ve içerik içeren mesaj dizinizi belirtin. Sunucu oluşturulan metinle yanıt verir. Bu, standart herhangi bir HTTP istemcisi veya SDK ile çalışır. Ham metin alırsınız, ekstra biçimlendirme yükü yoktur. Hatalar bir hata kodu içeren JSON döndürür. Karmaşık uygulamalar oluşturmadan önce kurulumunuzu doğrulamak için bu hızlı yolu kullanın.

Kimlik doğrulama ve base URL

Kimlik doğrulama, tek bir API anahtarının başlıkta iletilmesini içerir. Temel URL HTTPS://api.unzensierte.cc/v1'dir. Bu URL, base_url parametresi ayarlanarak resmi OpenAI SDK'ları ile çalışır. Anahtarınız hesabınızı tanımlar ve token kullanımını izler. Anahtarınızı API anahtarı al sayfasında oluşturun. Google veya e-posta ile kayıt olduktan hemen sonra görünür. Her istekte bu anahtarı kullanın. Geçersiz anahtarlar 401 hatası döndürür. Süresi dolmuş veya yetersiz kredi 402 hatası döndürür.

Anahtarınızı güvende tutun. Hesap başına bir aktif anahtar. Yeni bir anahtar, eskisini yerine geçirir. Kayıt için telefon numarası gerekmez. Erişim için gereken tek kimlik bilgisi API anahtarıdır.

Sohbet Tamamlamaları uç noktası

Temel uç nokta POST /v1/chat/completions'dur. Model, mesajlar ve parametreler içeren JSON yüklerini kabul eder. Model Kimliği "uncensored"dir. Mesajlar bir rol ve içerik dizesi gerektirir. Sistem, choices dizisinde oluşturulan metni döndürür. Sıcaklık, top_p ve durdurma dizileri gibi parametreleri ayarlayabilirsiniz. Bu parametreler yaratıcılığı ve çıktı uzunluğunu kontrol eder. API, yanıtta token kullanımını döndürür. Hatalar bir mesaj ve tür içerir. Tüm metin oluşturma görevleri için bu uç noktayı kullanın. Mevcut tek metin uç noktası budur. Burada gömme veya görüntü oluşturma yoktur.

Akış yanıtları ve kullanım

Akışı etkinleştirmek için stream parametresini true olarak ayarlayın. API, Sunucu Tarafından Gönderilen Olaylar (SSE) gönderir. Her parça kısmi metin içerir. Son parça token kullanım verilerini içerir. Bu, oluşturulan metnin gerçek zamanlı gösterilmesini sağlar. Parçaları uygulamanızda arabelleğe alın. Birleştirerek tam yanıtı oluşturun. Akış, uzun çıktılar için algılanan gecikmeyi azaltır. Sohbet arayüzleri veya canlı veri işleme için kullanın. Usage nesnesi yalnızca son parçada görünür.Faturalandırma için giriş ve çıkış tokenlarını izleyin. Akış sırasında oluşan hatalar yine bir hata nesnesi döndürür.

Fonksiyon çağırma ve JSON modu

Harici araçları entegre etmek için fonksiyon çağrısı kullanın. Araçları istek gövdesinde tanımlayın. Model argümanlarla araç çağrıları döndürür. İşlevlerinizi yürütmek için bu argümanları ayrıştırın. Belirli işlev adları veya auto için tool_choice'u ayarlayın. JSON modu çıktıyı geçerli JSON'a zorlar. response_format'i json_object olarak ayarlayın. Bu, ayrıştırma için yapılandırılmış veri sağlar. Bu özellikleri otomatik iş akışları için kullanın. Karmaşık ajan davranışları için birleştirin. Model standart OpenAI araç formatlarını destekler. Araç tanımlarınızın beklenen şemayla eşleştiğini doğrulayın.

Limitler ve hata yönetimi

Hız sınırlamaları anahtar başına dakikada 300 istektir. Eşzamanlılık, eşzamanlı 8 istekle sınırlıdır. İstek gövdeleri 8 MB altında olmalıdır. Hatalar, geçersiz anahtarlar için 401 gibi belirli kodlar içerir. 402 yetersiz ön ödemeli krediyi gösterir. 429 hız sınırının aşıldığını bildirir. Bağlam penceresi toplam 100,000 belirteçtir. Maksimum çıktı, istek başına 16,000 belirteçtir. Hatalar, hata ayrıntılarıyla birlikte JSON döndürür. 429 hataları için yeniden denemeleri işleyin. Yoğun kullanım öncesi kredi bakiyesini kontrol edin. Harcanan kredi için iade yapılmaz.

cURL

Copycurl https://api.unzensierte.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List 5 common Linux commands for file management"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Akış

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)