Venice AI API: İlk istek beş dakikada
Bu hızlı başlangıç kılavuzuyla Venice AI API'si için sansürsüz LLM'inizi beş dakikadan kısa sürede çalıştırın. OpenAI uyumlu uç noktaları kullanarak metin gönderin, yanıtları akış yapın ve şeffaf kullandıkça öde fiyatlandırma ile fonksiyon çağırın.
https://api.veniceapialternative.com/v1
Temel URL ve Kimlik Doğrulama
API anahtarı al sayfasında bir hesap oluşturarak başlayın. Yalnızca bir e-posta ve şifre gerekir; yedi gün boyunca geçerli olan 0,50 $'lık ücretsiz deneme kredisi almak için kredi kartı gerekmez. API anahtarınız kayıttan hemen sonra gösterilir ve istediğiniz zaman yeniden oluşturulabilir; bu eski anahtarı geçersiz kılar.
Resmi OpenAI SDK'larını veya herhangi bir OpenAI uyumlu istemciyi kullanırken temel URL https://api.veniceapialternative.com/v1 kullanın. API anahtarınızı Authorization üst bilgisinde bearer token olarak ayarlayın. Bu venice ai api uç noktası, istemci yapılandırmanızdaki varsayılan OpenAI temel URL'sinin yerini alır.
İlk İstek
Bağlantıyı test etmek için basit bir sohbet tamamlama isteği gönderin. Model kimliği her zaman uncensored şeklindedir. Bu açık ağırlıklı model GPU sunucularımızda çalışır ve yasal yetişkin kullanım için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır.
YOUR_API_KEY yerine gerçek anahtarınızı yazın. Yanıt, isteminize dayalı metin çıktısı döndürür.
curl https://api.veniceapialternative.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Python SDK Örneği
OpenAI Python kütüphanesini yükleyin ve temel URL'mizi kullanacak şekilde yapılandırın. Bu, OpenAI uç noktalarını bekleyen mevcut kod tabanlarından yararlanmanızı sağlar.
from openai import OpenAI
client = OpenAI(base_url="https://api.veniceapialternative.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 SDK Örneği
Node.js ortamları için openai paketini kullanın. İstemciyi özel temel URL ve API anahtarınızla başlatın. Bu, tüm isteklerin venice ai api altyapısı üzerinden yönlendirilmesini sağlar.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.veniceapialternative.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ış Yanıtları
İsteğinizde stream: true ayarlayarak akış özelliğini etkinleştirin. API, gerçek zamanlı token teslimi için Sunucu Tarafı Olayları (SSE) döndürür. Bu, metin oluşturulurken metni görüntülemesi gereken sohbet arayüzleri için kullanışlıdır.
stream = 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)
Hız Limitleri ve Kısıtlamalar
uncensored model, istem ve tamamlama için birlikte 100.000 token'lık bir bağlam penceresi destekler. Her API anahtarı için dakika başına 300 istekle sınırlısınız. İstek gövdeleri 8 MB'ı geçmemelidir.
Yaygın hatalar arasında 401 (geçersiz anahtar), 402 (yetersiz kredi) ve 429 (hız limiti aşıldı) yer alır. Ön ödemeli krediyi 10 $'dan başlayan tutarlarla yükleyin; krediler asla sona ermez. Kullanımınızı kilitleyen aylık abonelik yoktur.
API özellikleri
Kredi yüklemeden önce kontrol edebilmeniz için API'nin gerçek limitleri ve özellikleri tek yerde.
| Öğe | Değer |
|---|---|
| Biçim | OpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Model kimliği | uncensored |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.veniceapialternative.com/v1 |
| JSON modu | response_format: {"type": "json_object"} |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| İstek boyutu | en fazla 8 MB |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Hız limiti | anahtar başına dakikada 300 istek |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10 |
| Fiyat | 1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00 |
| Yükleme | USDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar |
| Ücretsiz deneme | $0,50, 7 gün, kart gerekmez · Deneme anahtarı: 2 paralel istek, dakikada 60; ilk yüklemeden sonra tam limitler (8 ve 300) |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
| Giriş | Google veya e-posta ve şifre |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
Hata kodları
Hatalar sabit bir type ile JSON olarak döner; başarısız veya reddedilen istekler ücretlendirilmez.
| Kod | Tür | Anlamı |
|---|---|---|
400 | bad_request | geçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun |
401 | missing_key · invalid_key · key_revoked | anahtar yok, yanlış veya değiştirilmiş |
402 | no_credit | kredi bitti — yükleyin, hemen devam eder |
403 | content_blocked | reşit olmayanları içeren cinsel içerik — reddedildi, ücret yok |
404 | not_found | bilinmeyen uç nokta |
413 | request_too_large | gövde 8 MB'tan büyük |
429 | rate_limited · concurrency | dakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin |
503 | upstream_busy | model meşgul — birkaç saniye sonra tekrar deneyin |
Sorular ve cevaplar
Bu resmi Venice.ai API'si mi?
Hayır. Bu, sansürsüz açık ağırlıklı bir model barındıran bağımsız bir hizmettir. Venice.ai'nin ana platformuyla veya başka bir satıcının modelleriyle bağlantılı değildir veya onların satıcısı değildir.
Bu API görüntü veya ses oluşturmayı destekliyor mu?
Hayır. Bu yalnızca metin tabanlı bir sohbet tamamlama API'sidir. Gömme (embedding), görüntü oluşturma, ses, video veya ince ayar (fine-tuning) desteklemez.
Deneme kredim süresi dolduğunda ne olur?
Deneme krediniz yedi gün sonra sona erer. Kripto para (USDT veya USDC) ile 10 $'dan başlayan bakiye yükleyebilirsiniz. Ön ödemeli krediler asla sona ermez ve API anahtarınızı istediğiniz zaman yeniden oluşturabilirsiniz.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın ve temel URL'yi değiştirin. Kurulumun tamamı budur.