Geliştiriciler için Venice API dokümantasyonu

Kimlik doğrulama ve base URL

Temel URL'yi şuna ayarlayarak hemen bağlayın https://api.veniceapi.com/v1 ve API anahtarınızı Authorization header. Bu anahtarı Google veya e-posta ile kayıt olduktan sonra anında elde edersiniz. Bu tek model, yönlendirme mantığı olmadan tüm metin üretimini halleder. Birden fazla uç nokta veya proxy yapılandırması yönetmenize gerek yoktur.

Anahtarınızı güvende tutun. Her hesapta aynı anda yalnızca bir aktif anahtar bulunur; yeni bir tane oluşturmak öncekini geçersiz kılar. Bu, token kullanımı ve faturalandırma için net atama sağlar.

Sohbet tamamlamaları uç noktası

Metin isteklerini /v1/chat/completions standart HTTP POST yöntemleri kullanan uç nokta. API, model adı, sistem talimatları ve kullanıcı mesajlarını içeren bir JSON yükü kabul eder.

Temel bir istek yapısı:

Copycurl https://api.veniceapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check if the service blocks adult content in the test endpoint"}]
  }'

Yanıt, oluşturulan metni, token kullanım istatistiklerini ve tamamlama bayraklarını döndürür. Davranışı temperature ou top_p. Bu ayarlar, çıktıda yaratıcılığı ve rastgeleliği kontrol eder.

Hatalar standart HTTP kodları döndürür. 401 geçersiz bir anahtarı, 402 ise yetersiz krediyi belirtir. Bu kodları otomasyon iş akışlarınızda hataları zarifçe yönetmek için kullanın.

Python SDK entegrasyonu

Resmi OpenAI Python kütüphanesini uncensored LLM ile etkileşim kurmak için kullanın. İstemciyi Venice base URL'si ve API anahtarınızla yapılandırın. Bu yaklaşım, istek oluşturma ve yanıt ayrıştırmayı basitleştirir.

Copyfrom openai import OpenAI

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

Bu yöntem, OpenAI için tasarlanmış mevcut kod tabanlarıyla sorunsuz çalışır. Uygulama mantığınızı önemli ölçüde değiştirmeden temel URL'yi değiştirebilirsiniz. Kütüphane otomatik olarak seri hale getirme ve ağ bağlantılarını yönetir.

Model tanımlayıcısının uncensored. Bu, Venice tarafından sağlanan özel ayarlanmış modeli kullandığınızdan emin olursunuz. Diğer modeller aynı davranış kalıplarını sergilemeyebilir.

Node SDK entegrasyonu

OpenAI Node SDK'sını kullanarak JavaScript veya TypeScript projelerinize API'yi entegre edin. baseURL Venice endpoint'ine ve API anahtarınızı sağlayın. Bu kurulum senkron ve asenkron işlemleri destekler.

Copyimport OpenAI from "openai";

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

Bu entegrasyon, sohbet botları, içerik üreticileri veya veri çıkarma araçları hızlıca oluşturmanıza olanak tanır. SDK, istek yaşam döngisini, yeniden denemeleri ve hata yönetimini yönetir. Gelişmiş kullanım durumları için gerekirse özel başlıklar iletebilirsiniz.

SDK'nın doğru sürümünü içe aktardığınızdan emin olun. Eski sürümler Venice API'de mevcut olan tüm özellikleri desteklemeyebilir. Uyumluluk ayrıntıları için belgelere bakın.

SSE aracılığıyla akış yanıtları

Şu ayarlayarak gerçek zamanlı çıktı etkinleştirin stream parametresi true. API, tam bir JSON nesnesi yerine bir Sunucu Tarafı Olayları (SSE) akışı döndürür. Bu, tokenların oluşturulurken görüntülenmesine olanak tanı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)

Akış, algılanan gecikmeyi azaltır. Sohbet arayüzleri veya canlı panolar için idealdir. Akışın son parçası, son token kullanım istatistiklerini içerir. Maliyetleri doğru bir şekilde izlemek için bu verileri ayrıştırın.

Bağlantı kopmalarını zarif bir şekilde yönetin. Akış kesilirse isteği yeniden deneyebilirsiniz. API, aynı anda birden fazla akış aktifken sıralamayı garanti etmez. Yüksek trafik sırasında hız sınırlarınızı yakından izleyin.

Hata yönetimi ve sınırlamalar

API, anahtar başına dakikada 300 istek için bir hız sınırı uygular. Eşzamanlı istekler anahtar başına 8 ile sınırlıdır. İstek gövdeleri 8 MB'ı aşmamalıdır. Bu sınırları aşmak, 429 Çok Fazla İstek hatını döndürür.

Bağlam penceresi boyutu, istem ve tamamlama birleştirilmiş olarak 100.000 belirteçtir. İstek başına maksimum çıktı 16.000 belirteçtir. Eğer max_tokens ayarlanmamışsa, limit varsayılan olarak 2.048 token'a düşer. Kırpılmaları önlemek için girdilerinizi buna göre planlayın.

Yaygın hatalar arasında geçersiz anahtarlar için 401 ve yetersiz kredi için 402 bulunur. Bu kodları kullanıcıları yeniden yükleme yapmaya teşvik etmek için işleyin. Faturalandırma sorunları için destek sayfasını kullanın. Kredi asla süresi dolmaz, bu nedenle daha sonra yükleyebilirsiniz.