TR ▾

Geliştiriciler için sansürsüz AI API alternatifi

https://api.veniceapialternative.com/v1

veniceapialternative.com

Venice AI API Uç Noktası: Başka Bir Temel URL'ye Geçiş

Kodunuz bir Venice AI API uç noktasına işaret ediyorsa ve başka bir sağlayıcıyı denemek istiyorsanız, değişiklik küçüktür: bir temel URL, bir anahtar ve bir model kimliği. Bu sayfa neyi düzenleyeceğinizi, neyi test edeceğinizi ve sonrasında neyin farklı davrandığını listeler.

güncellendi

Temel URL geçişini gösteren iki sunucu bloğu arasında hareket eden bir kablo fişi

Temel noktalar

  • Dört düzenleme çoğu geçişi kapsar: temel URL, API anahtarı, model kimliği, bakiye yönetimi.
  • Yeni temel URL https://api.veniceapialternative.com/v1'dir ve model kimliği uncensored'dır.
  • Üç uç nokta desteklenir: sohbet tamamlamaları, yanıtlar ve modeller.
  • Gerçek trafiği yönlendirmeden önce $0,50 deneme kredisi ile test yapın.

Kısa cevap: dört düzenleme

OpenAI sohbet formatını destekleyen herhangi bir istemci, farklı bir sağlayıcıya erişmek için yalnızca yapılandırma değişiklikleri gerektirir. Bir Venice AI API uç noktası için durum tersinedir: dört değeri değiştirirsiniz, entegrasyonunuzu yeniden yazmazsınız.

  1. Temel URL: değerini https://api.veniceapialternative.com/v1 olarak ayarlayın.
  2. API anahtarı: API anahtarı sayfasında bir tane oluşturun ve Authorization: Bearer <key> olarak gönderin.
  3. Model kimliği: uncensored kullanın. Tek bir model olduğu için eşlenecek model listesi yoktur.
  4. Bakiye kontrolleri: X-Balance-USD başlığını okuyun veya GET /v1/balance çağrısı yapın.

Bu bağımsız bir hizmettir; Venice veya başka herhangi bir satıcı tarafından işletilmez veya onlarla ilişkili değildir. Tek bir açık ağırlıklı model barındırır, bu nedenle kodunuzda daha önce kullandığınız her model adı değiştirilmelidir.

Düzenlemeden önce: uç noktanın nerede olduğunu bulun

Temel URL nadiren yalnızca bir dosyada bulunur. Eski ana bilgisayar adını, eski model dizisini ve anahtarı barınduran ortam değişkenini depo içinde arayın. Tipik gizlenme yerleri SDK oluşturucuları, .env dosyaları, Docker veya CI gizli bilgileri, ön uç yapılandırması ve ana uygulamadan ayrı yazılmış arka plan işçileridir.

Faydalı bir alışkanlık, önce bu üç değeri ortam değişkenlerine taşımak, sonra geçişi yapmaktır. Bu, geçişi dağıtım zamanı bir değişikliğe dönüştürür ve tek satırlık bir geri alma imkanı sağlar.

export LLM_BASE_URL="https://api.veniceapialternative.com/v1"
export LLM_API_KEY="YOUR_KEY"
export LLM_MODEL="uncensored"

Python, Node ve curl için kod

Python (openai SDK)

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ.get("LLM_BASE_URL", "https://api.veniceapialternative.com/v1"),
    api_key=os.environ["LLM_API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Say hello in five words." }],
});
console.log(resp.choices[0].message.content);

curl

curl -i https://api.veniceapialternative.com/v1/chat/completions \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'

-i bayrağı yanıt başlıklarını yazdırır; bu şekilde ilk çağrıda X-Request-Id ve X-Balance-USD değerlerini görürsünüz.

Ne değişmez ve ne değişir

İstek yapısı tanıdık şekildedir: rollerle messages, stream, tools, tool_choice, JSON modu için response_format ve örnekleme parametreleri temperature, top_p, stop, seed ve cezalar. Akış, sonunda kullanım bilgisiyle SSE kullanır ve araç sonuçları role: "tool" mesajları olarak geri döner.

ÖğeBurada
Uç noktalarPOST /v1/chat/completions, POST /v1/responses, GET /v1/models
Model kimliğiuncensored (tek model)
Bağlam penceresi100.000 token, istem ve tamamlama
Maksimum istek gövdesi8 MB
ModlarYalnızca metin: görüntü, ses, video, gömme veya ince ayar yok

Son satır geçişleri bozan kısımdır. Uygulamanız eski sağlayıcıda bir görüntü, konuşma veya gömme yoluna çağrı yapıyorsa, bu çağrıların burada eşdeğeri yoktur. O kısmı mevcut sağlayıcınızda tutun ve yalnızca metin çağrılarını taşıyın.

Limitleri ve hataları farklı şekilde yönetin

Tam anahtar 8 eşzamanlı istek ve dakika başına 300 istek izni verir. Deneme anahtarı 2 eşzamanlı ve dakika başına 60 istek izni verir. Bu limitlerin ötesine geçtiğinizde HTTP 429 alırsınız; dakika başı istekler için rate_limited hata kodu veya aynı anda çok fazla istek için concurrency hata kodu ile. Retry-After: 5 başlığı içeren bir 429 geçici aşırı yük anlamına gelir: bekleyin ve yeniden deneyin.

Akışlı bir istek, akış bitene kadar eşzamanlılık slotunu meşgul tutar. Eski entegrasyonunuz onlarca eşzamanlı istek gönderiyorsa, istemcinin önüne 8 veya daha az yarımlayıcı yerleştirin.

import time, random
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.veniceapialternative.com/v1", api_key="YOUR_KEY")

def ask(prompt, tries=4):
    for i in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 + random.random() * i)
    raise RuntimeError("still rate limited")

Başarısız veya reddedilen istekler ücretlendirilmez, bu nedenle hatalarda yeniden denemeler kredinizden düşmez.

Geçişten sonra akış ve fonksiyon çağırma

Uygulamanız tokenları bir kullanıcı arayüzüne akışıyorsa istemcide hiçbir şey değişmez: stream: true ayarlayın ve sunucu tarafından gönderilen olayları okuyun. Kullanım bloğu akışın sonunda gelir; bu, her yanıtın maliyetini günlüğe kaydetmek için kullanışlıdır.

from openai import OpenAI

client = OpenAI(base_url="https://api.veniceapialternative.com/v1", api_key="YOUR_KEY")

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "List three uses of a message queue."}],
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")
    if chunk.usage:
        print("\n", chunk.usage)

Araç çağırma, zaten bildiğiniz akışı izler. tools ve isteğe bağlı olarak tool_choice iletirsiniz, model tool_calls döndürür (akış durumunda parçalar halinde), fonksiyonu çalıştırırsınız ve sonucu role: "tool" mesajı olarak geri gönderirsiniz. JSON modu response_format: {"type": "json_object"} ile çalışır. Her zaman ayrıştırılmış JSON'u kodunuzda doğrulayın, çünkü hiçbir model bir şema garantisi vermez.

Geçişten sonra sık karşılaşılan sorunlar

  • Kimlik doğrulama hataları. Anahtarın Bearer token olarak gönderildiğinden ve tüm dizenin kopyalandığından emin olun. Eski sağlayıcıdan gelen bir anahtar burada çalışmaz.
  • Bulunamadı hataları. Base URL, /v1 ile bitmelidir. Tam /chat/completions yolunu, bunu tekrar ekleyen bir SDK'ya yapıştırırsanız rota yanlış olur.
  • Bilinmeyen model. uncensored dışındaki herhangi bir model dizesi yanlıştır. Yapılandırma ve testlerde sabit kodlanmış isimleri arayın.
  • 429 patlamaları. Eşzamanlılığı anahtar türünüzün eşzamanlılığına indirin ve Retry-After değerine uyun.
  • Beklenmeyen maliyet. Uzun sohbet geçmişi her adımda girdi olarak faturalandırılır. Kısaltın.

Hâlâ bir şey yanlış görünüyorsa, yanıtın X-Request-Id değerini destek sayfası bağlantısı üzerinden iletin. Bu, tam isteği tanımlar ve her iki tarafta da zaman kazandırır.

Geçiş kontrol listesi ve test

Bu sırayla ilerleyin. Her adım küçük, tersine çevrilebilir bir değişikliktir.

  1. API anahtarı sayfasından $0,50 deneme kredisi talep edin. Kart gerektirmez ve 7 gün sürer. Ödeme için yalnızca kripto (USDT/USDC) kabul edilir.
  2. Yukarıdaki curl çağrısını çalıştırın ve yanıtı ile başlıkları onaylayın.
  3. Kritik olmayan bir kod yolunu yeni temel URL ve anahtara geçirin.
  4. Gerçek istemlerin bir örneğini yeniden oynatın ve çıktı kalitesini, uzunluğunu ve gecikmesini gözle karşılaştırın.
  5. Yanıtlardaki usage değerini kontrol edin ve hacminizi 1M girdi token başına $0.15 ve 1M çıktı token başına $0.50 ile çarpın.
  6. X-Balance-USD üzerinde bakiye uyarısı ekleyin.
  7. Bakiye yükleyin (en az $20, $50'den itibaren bonuslar ile) ve kalan trafiği yönlendirin.

Başka bir modelin tuhaflıklarına bağlı istemler küçük düzenlemeler gerektirebilir, örneğin farklı bir sistem istemi. Model değiştirirken bu normaldir, bu nedenle tek bir yanıta değil, kendi test setinize dayanarak değerlendirin. Bu model, yasal yetişkin kullanımı için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır ve reşit olmayanlar içeren cinsel içeriklere izin verilmez.

dokümantasyon her uç nokta ve başlığı açıklar. Venice API alternatifi sayfamız ürünün karşılaştırmasını, fiyatlandırma sayfası ise bakiye yükleme miktarlarını, bonusları ve ödeme yöntemlerini gösterir. API'ye gönderilen istemler eğitim için kullanılmaz ve kredi süresi dolmaz, bu nedenle küçük bir bakiye yükleme son tarih taşımaz.

Sorular ve cevaplar

Temel URL nedir?

https://api.veniceapialternative.com/v1'i herhangi bir OpenAI uyumlu istemci ile kullanın ve anahtarınızı Bearer token olarak gönderin.

Hangi model ID'sini göndermeliyim?

uncensored gönderin. Tek bir model bulunduğundan, eski model adlarınızdan eşleme yapmanıza gerek yoktur.

Bakiyemi nasıl kontrol ederim?

X-Balance-USD yanıt başlığını okuyun, GET /v1/balance uç noktasını çağırın veya OpenAI tarzı GET /v1/dashboard/billing/credit_grants uç noktasını kullanın.

Görüntü veya embedding uç noktalarını çağırabilir miyim?

Hayır. API yalnızca metin içindir; görüntü, ses, video, embedding veya ince ayar uç noktaları bulunmamaktadır.

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.

API anahtarı al