Venice AI API'sini Dakikalar İçinde Entegre Edin

Temel URL ve Kimlik Doğrulama Kurulumu

API şurada yaşar: https://api.veniceaiapi.com/v1. Tek bir API anahtarı kullanarak kimlik doğrulaması yaparsınız Authorization header.

Google veya e-posta ile kaydolun ve anahtarınızı anında edinin. Telefon numarası gerekmez. Anahtarınızı temel URL'yi ayarlayarak herhangi bir OpenAI uyumlu SDK ile kullanın.

Her hesabın tek bir aktif anahtarı vardır. Yeni bir anahtar oluşturmak eskisini hemen iptal eder. Bu durum, karmaşık izin kapsamı olmadan basit erişim kontrolü sağlar.

Göndermeniz gereken model kimliği "uncensored". Yasal yetişkin kullanım için içerik reddi olmadan cevap verecek şekilde ayarlanmış açık ağırlıklı bir modeldir.

• Temel URL: https://api.veniceaiapi.com/v1
• Auth Header: Authorization: Bearer YOUR_API_KEY
• Model: uncensored

Bağlantıyı basit bir GET isteği ile test edebilirsiniz: /v1/models. Bu, ağır yükler göndermeden önce anahtarınızın çalıştığını doğrular.

/v1/chat/completions Uç Noktası

Metin prompt'larını POST /v1/chat/completions ve metin yanıtları alın. Bu uç nokta tüm standart sohbet etkileşimlerini işler.

Rol ve içerik alanlarına sahip mesajlar dizinizi ekleyin. Model girdiyi işler ve bir tamamlama döndürür. Çıktı uzunluğunu kullanarak kontrol edebilirsiniz. max_tokens parametre.

Varsayılan maksimum çıktı 2.048 token'dır. İstek başına bunu 16.000 tokena kadar artırabilirsiniz. Toplam bağlam penceresi, istem ve tamamlama birleşimi için 100.000 tokena izin verir.

Hatalar ve reddetmeler ön ödemeli kredinizi tüketmez. Bu, yalnızca başarılı token üretimi için ödeme yaptığınız anlamına gelir.

Model Parametreleri: Sıcaklık, Top-P ve Seed

Çıktının rastgeleliğini standart LLM parametreleriyle kontrol edin. Ayarlayın temperature yaratıcılığı ayarlayın. Daha düşük değerler, yanıtları daha belirleyici ve odaklı hale getirir.

Kullan top_p nükleus ökleme için. Bu, modelin olasılık kütlesinin en üst yüzdesini dikkate almasını sınırlar. Tekrarlayan veya anlamsız çıktılar önlenir.

Ayarla seed tekrarlanabilir sonuçlar için. Bu, belirli istem varyasyonlarını hata ayıklamak veya test etmek için kullanışlıdır. Ayrıca şunu da kullanabilirsiniz stop belirli noktalarda üretimi durdurmak için diziler.

Diğer desteklenen parametreler şunları içerir presence_penalty ve frequency_penalty. Bunlar, uzun konuşmalarda token çeşitliliğini yönetmeye yardımcı olur.

Kullanım durumunuza uyması için bu ayarları kullanın. Rol yapma daha yüksek sıcaklıktan yararlanır. Kod üretimi daha düşük değerlere ihtiyaç duyabilir.

Sunucu Tarafı Olayları (SSE) ile Akış Yanıtları

Ayarlayarak akışı etkinleştirin stream: true istek içinde. API, tek bir JSON nesnesi yerine Sunucu Tarafı Olayları (SSE) döndürür.

Her bir parça kısmi metin içeriği içerir. Bu, sonuçları kullanıcılarınıza gerçek zamanlı olarak görüntülemenizi sağlar. Uzun yanıtlar için algılanan gecikmeyi önemli ölçüde iyileştirir.

Son parça toplam token kullanım istatistiklerini içerir. Kredi tüketiminizi gerçek zamanlı ve doğru bir şekilde takip edebilirsiniz.

Akış hatalarını zarifçe yönetin. Ağ kesintileri yanıtı kesintiye uğratabilir. Gerekirse isteği devam ettirebilir veya yeniden deneyebilirsiniz.

Fonksiyon Çağırma ve JSON Modu

API'yi arka uç mantığınızla entegre etmek için fonksiyon çağrısı kullanın. Araçlarınızı isteğinizde tanımlayın ve model yapılandırılmış JSON argümanları döndürecektir.

Ayarla response_format: {"type": "json_object"} katı JSON çıktısını zorlamak için. Bu, verileri uygulamanıza ayrıştırmak için idealdir.

İşlev çağırma, akış (streaming) ile birlikte çalışır. Yapılandırılmış verileri gerçek zamanlı olarak alabilirsiniz. Bu, karmaşık çok adımlı etkileşimleri mümkün kılar.

Model araç tanımlarını anlar ve buna göre yürütür. Araç yürütme mantığını kendi kodunuzda yönetirsiniz.

Bu özellik, ajanlar oluşturma veya otomatik iş akışları oluşturma için API'yi uygun hale getirir.

Saniye Başına İstek Limitleri ve Token Kısıtlamaları

Her API anahtarı dakikada 300 istekle sınırlıdır. Aynı anda 8 eşzamanlı istek yapabilirsiniz. Bu, ani artışların sistemi aşırı yüklemesini önler.

Maksimum istek gövdesi boyutu 8 MB'tır. Yüklerinizin bu sınıra sığdığından emin olun. Büyük bağlam pencereleri bu kotayı hızla tüketir.

Yaygın hatalar arasında geçersiz anahtarlar için 401 ve yetersiz kredi için 402 bulunur. Bir 429 hatası hız sınırına ulaştığınızı gösterir.

Krediler için iade mevcut değildir. Ancak çift ücretlendirme gibi hatalar Destek üzerinden düzeltilir. Krediniz süresi dolmaz.

Fiyatlandırma, 1M giriş token'ı başına $0.15 ve 1M çıktı token'ı başına $0.50'dir. Yüklemeler yalnızca kripto para ile $20 ile $500 arasında yapılır.

cURL

Copycurl https://api.veniceaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return status as json"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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)