Tek bir kod satırı bile yeniden yazmadan yapay zeka sağlayıcılarını değiştirebildiğinizi düşünün? Venice API tam olarak bunu sunar: sıfır veri saklama, sansürsüz model seçenekleri ve kontrolünüzde olan gizlilik odaklı mimariye sahip OpenAI uyumlu uç noktalar.
Çoğu yapay zeka API'si sizi satıcıya özel SDK'lara zorlar, verilerinizi model eğitimi için saklar ve temel özellikler için yüksek ücretler talep eder. Sağlayıcıları değiştirirken uygulamanızı yeniden yazarsınız. İstemleriniz rakip modelleri eğitir. Maliyetleriniz öngörülemez bir şekilde artar.
Venice API bu sürtünme noktalarını ortadan kaldırır. OpenAI'nin API yapısını aynen yansıtır; sadece temel URL'yi değiştirin ve mevcut kodunuz anında çalışır. Verileriniz gizli kalır. Kripto stake etme ve kullandıkça öde USD kredileri dahil olmak üzere birden fazla ödeme modelinden seçim yapabilirsiniz.
Geliştirici Ekibinizin maksimum verimlilikle birlikte çalışması için entegre, Hepsi Bir Arada bir platform mu istiyorsunuz?
Apidog tüm taleplerinizi karşılar ve Postman'i çok daha uygun bir fiyata değiştirir!
Venice API Anahtarınızı Oluşturma
1. venice.ai/settings/api adresine gidin.
2. "Yeni API Anahtarı Oluştur"a tıklayın ve kimlik bilgilerinizi yapılandırın:
- Açıklama: Anahtarınızı düzenlemek için adlandırın
- Tip: Yönetici anahtarları diğer anahtarları programatik olarak yönetir; Yalnızca çıkarım anahtarları modelleri özel olarak çalıştırır
- Sona Erme: Anahtarın otomatik olarak devre dışı kalacağı isteğe bağlı tarih
- Tüketim Limitleri: Harcamaları kontrol etmek için günlük Diem veya USD limitleri
3. Anahtarınızı hemen kopyalayın. Venice onu bir kez görüntüler! Ortam değişkenlerinde saklayın, asla kod depolarında değil.
export VENICE_API_KEY="your-key-here"
Anahtar Güvenliği Hususları
Yönetici anahtarları, Venice hesabınıza geniş erişim sağlar. Onları kök kimlik bilgileri gibi değerlendirin; anahtar rotasyon betikleri ve ekip yönetimi için kullanın, asla uygulama kodunda değil. Yalnızca çıkarım anahtarları işlemleri model yürütmeyle sınırlar, sızdırılması durumunda maruziyeti azaltır. Eskimiş kimlik bilgilerini tespit etmek için kontrol panelinin etkinlik günlüklerini kullanarak anahtarları üç ayda bir değiştirin.
Venice API'sinin Kimlik Doğrulaması ve Temel Yapılandırması
Venice standart Bearer token kimlik doğrulamasını kullanır. Her istek iki başlık gerektirir:
Authorization: Bearer $VENICE_API_KEY
Content-Type: application/json
Temel URL, OpenAI'nin modelini aynen takip eder:
import openai
import os
client = openai.OpenAI(
api_key=os.getenv("VENICE_API_KEY"),
base_url="https://api.venice.ai/api/v1"
)
Bu tek yapılandırma değişikliği, mevcut tüm OpenAI SDK çağrılarınızı Venice'in altyapısı üzerinden yönlendirir. Yöntem değişikliği yok. Parametre yeniden yazımı yok. Kodunuz anında çalışır.
SDK Uyumluluğu
Venice, OpenAI'nin Python, TypeScript, Go, PHP, C#, Java ve Swift dillerindeki resmi SDK'larıyla uyumluluğu sürdürmektedir. OpenAI spesifikasyonu üzerine inşa edilmiş üçüncü taraf kütüphaneler de değişiklik yapmadan çalışır. Sadece temel URL'yi ve API anahtarını değiştirerek mevcut kod tabanınızı Venice'e karşı test edin—standart sohbet tamamlama, akış veya fonksiyon çağırma kullanıyorsanız, geçiş dakikalar sürer.
OpenAI'den Geçiş
Geçiş üç değişiklik gerektirir: temel URL, API anahtarı ve model adı. https://api.openai.com/v1 adresini https://api.venice.ai/api/v1 ile değiştirin. OpenAI API anahtarınızı Venice anahtarınızla değiştirin. Model tanımlayıcılarını gpt-4 veya gpt-3.5-turbo'dan qwen3-4b gibi Venice eşdeğerlerine değiştirin. Üretim dağıtımından önce kapsamlı bir şekilde test edin. Akış yanıtlarının doğru işlendiğini doğrulayın. Fonksiyon çağırma şemalarının doğrulandığını onaylayın. Görüntü oluşturma parametrelerinin gereksinimlerinize uygun olup olmadığını kontrol edin. Venice'in uyumluluk katmanı çoğu uç durumu ele alır, ancak hata mesajı biçimlendirmesinde ve hız sınırı başlıklarında ince farklılıklar mevcuttur.
İpucu: Tüm API uç noktalarınızı Apidog ile kapsamlı bir şekilde test edin.
Temel Venice API Uç Noktaları ve Yetenekleri
Venice, metin, görüntü, ses ve video üretimini kapsayan dokuz farklı uç nokta sunar:
Metin Üretimi
/api/v1/chat/completions- Akış desteğiyle konuşma yapay zekası/api/v1/embeddings/generate- RAG uygulamaları için vektör gömme
Görüntü İşleme
/api/v1/image/generate- Metinden görüntü oluşturma/api/v1/image/upscale- Çözünürlük iyileştirme/api/v1/image/edit- Yapay zeka destekli boyama ve düzenleme
Ses
/api/v1/audio/speech- Metin-konuşma sentezi/api/v1/audio/transcriptions- Konuşmadan metne dönüştürme
Video ve Karakterler
/api/v1/video/queue- Metinden/videodan videoya oluşturma/api/v1/characters/list- Yapay zeka kişilik yönetimi
Her uç nokta, uygun olduğu yerlerde OpenAI uyumlu istek/yanıt formatlarını korur. Mevcut ayrıştırma mantığını yeniden kullanırsınız.
Uç Nokta Seçim Stratejisi
Uç noktaları kullanım senaryonuzun karmaşıklığına göre eşleştirin. Sohbet tamamlama çoğu metin üretimi ihtiyacını karşılar. Semantik arama veya RAG boru hatları için gömmeler ekleyin. Yaratıcı iş akışları veya içerik denetimi için görüntü uç noktalarını kullanın. Ses uç noktaları erişilebilirlik özelliklerini veya sesli arayüzleri etkinleştirir. Tek bir uç nokta ile başlayın, entegrasyonunuzu doğrulayın, ardından çok modlu iş akışlarına genişletin.
Akışlı Yanıtlarla Çalışma
Akış, sohbet uygulamaları için algılanan gecikmeyi azaltır. Venice, OpenAI'nin uygulamasıyla aynı olan Sunucu Tarafından Gönderilen Olayları (SSE) kullanır. Tam yanıtları beklemek yerine kısmi içeriği geldikçe işleyin. Akış sonlandırmayı [DONE] mesajlarını kontrol ederek ele alın. Kesintiye uğrayan akışlar için yeniden bağlantı mantığı uygulayın—sohbet geçmişini istemci tarafında depolayın ve başarısız istekleri yeniden deneyin. Gerçek zamanlı maliyetleri takip etmek için akış parçacıklarındaki token kullanımını izleyin.
Venice API'ye Özel Parametreler
OpenAI'nin standart parametrelerinin ötesinde, Venice venice_parameters nesnesi aracılığıyla yetenek kontrolleri ekler:
{
"model": "qwen3-4b",
"messages": [{"role": "user", "content": "Latest AI developments?"}],
"venice_parameters": {
"enable_web_search": "on",
"enable_web_citations": true,
"strip_thinking_response": false
}
}
Web Arama Entegrasyonu
enable_web_search'i auto, on veya off olarak ayarlayın. Otomatik, modelin güncel bilgilerin yanıtları ne zaman iyileştireceğine karar vermesini sağlar. Yakın zamanda yaşanan olaylar veya hızla değişen teknolojiler hakkındaki gerçek zamanlı sorgular için açık konuma zorlayın. Araştırma araçları ve gerçek doğrulama için gerekli olan kaynak URL'leri döndürmek üzere enable_web_citations ile eşleştirin.
Muhakeme Kontrolü
DeepSeek R1 gibi muhakeme modelleri varsayılan olarak adım adım düşünme gösterir. Yalnızca nihai yanıtları döndürmek ve token tüketimini azaltmak için strip_thinking_response'ı true olarak ayarlayın. Basit sorgular için muhakemeyi tamamen atlamak üzere disable_thinking kullanın.
Alternatif Sözdizimi
Özet istekler için model soneki aracılığıyla parametreleri iletin:
model="qwen3-4b:enable_web_search=on&enable_web_citations=true"
Parametre Hiyerarşisi
Venice'e özgü parametreler varsayılanları geçersiz kılar ancak açık ayarları dikkate alır. Kök nesnede temperature: 0.5 ve venice_parameters içinde enable_web_search: on belirtirseniz, her ikisi de aynı anda uygulanır. Üretime dağıtmadan önce parametre kombinasyonlarını ayrı ayrı test edin—bazı parametreler belirli modellerle öngörülemeyen bir şekilde etkileşime girer.
Venice API Kullanılırken Pratik Uygulama Örnekleri
Temel Sohbet Tamamlama
curl --request POST \
--url https://api.venice.ai/api/v1/chat/completions \
--header "Authorization: Bearer $VENICE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "qwen3-4b",
"messages": [{"role": "user", "content": "Explain zero-knowledge proofs"}],
"stream": true
}'
Akış, OpenAI ile aynı şekilde çalışır—SSE parçalarını geldikçe işleyin.
Fonksiyon Çağırma
curl --request POST \
--url https://api.venice.ai/api/v1/chat/completions \
--header "Authorization: Bearer $VENICE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "qwen3-4b",
"messages": [{"role": "user", "content": "Weather in Tokyo?"}],
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get weather for location",
"parameters": {
"type": "object",
"properties": {
"location": {"type": "string"}
},
"required": ["location"]
}
}
}]
}'
Venice modelleri, OpenAI'nin uygulaması gibi paralel fonksiyon çağırma ve şema zorlamayı destekler.
Görüntü Üretimi
curl --request POST \
--url https://api.venice.ai/api/v1/image/generate \
--header "Authorization: Bearer $VENICE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "venice-sd35",
"prompt": "Cyberpunk cityscape at night, neon reflections",
"aspect_ratio": "16:9",
"resolution": "2K",
"hide_watermark": true
}'
Mevcut en boy oranları 1:1, 4:3, 16:9 ve 21:9'u içerir. Çözünürlük seçenekleri 1K ve 2K'dır.
Görüntü Yükseltme
curl --request POST \
--url https://api.venice.ai/api/v1/image/upscale \
--header "Authorization: Bearer $VENICE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "upscale-sd35",
"image": "base64encodedimage..."
}'
Görüş Analizi
curl --request POST \
--url https://api.venice.ai/api/v1/chat/completions \
--header "Authorization: Bearer $VENICE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "qwen3-vl-235b-a22b",
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "What architecture style is this?"},
{"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,..."}}
]
}]
}'
Görüntüleri base64 veri URI'leri veya HTTPS URL'leri olarak iletin. Görüş modelleri, karşılaştırma görevleri için mesaj başına birden fazla görüntü kabul eder.
Ses Sentezi
curl --request POST \
--url https://api.venice.ai/api/v1/audio/speech \
--header "Authorization: Bearer $VENICE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "tts-kokoro",
"input": "Welcome to Venice API",
"voice": "af_sky",
"response_format": "mp3"
}'
Ses seçenekleri önekler kullanır: af_ (Amerikalı kadın), am_ (Amerikalı erkek) ve diğer aksanlar için benzer kalıplar.
Hata Yönetimi Desenleri
Venice standart HTTP durum kodları döndürür. 401 kimlik doğrulama hatalarını gösterir—API anahtarınızı ve başlıklarınızı doğrulayın. 429 hız sınırlamasını belirtir; 1 saniyeden başlayarak üstel geri çekilme uygulayın. 500 hataları geçici altyapı sorunlarını gösterir; 5 saniye sonra tekrar deneyin. Belirli mesajlar için hata yanıtlarını ayrıştırın—Venice, yanıt gövdesinde ayrıntılı hata nedenleri içerir.
Venice API'sinin Gizlilik ve Veri Mimarisi
Venice'in sıfır veri saklama politikası, sadece yasal vaatlerle değil, teknik mimari aracılığıyla işler. Tarayıcınız konuşma geçmişini IndexedDB kullanarak yerel olarak depolar. Venice sunucuları, istemleri yalnızca mevcut isteği gören GPU'lar üzerinde işler—konuşma geçmişi yok, kullanıcı kimliği meta verileri yok, API anahtar bilgisi yok.
Yanıt oluşturulduktan sonra, sunucular istemi ve çıktıyı anında siler. Hiçbir şey diske veya günlüklere kalıcı olarak kaydedilmez. Verileriniz asla modelleri eğitmez. Bu, kötüye kullanımı tespiti ve model iyileştirme için verileri saklayan merkezi hizmetlerden temelden farklıdır.
Ek gizlilik için Venice, çoğu modeli üçüncü taraf sağlayıcılara güvenmek yerine özel altyapıda barındırır. Sansürsüz seçenekler, dış filtreleme veya günlük kaydı olmamasını sağlayarak Venice kontrolündeki donanımda çalışır.
Veri Akışı Doğrulaması
Ağ trafiğini izleyerek Venice'in gizlilik iddialarını denetleyin. API istekleri, TLS şifrelemesi ile doğrudan api.venice.ai adresine gider. Belgelerde üçüncü taraf analitik betikleri yüklenmez. Yanıt başlıkları önbellekleme yönergeleri göstermez—sunucu tarafı saklamama durumunu doğrular. Hassas uygulamalar için, istemleri göndermeden önce istemci tarafı şifreleme uygulayın, ancak bu, modelin içeriği anlamasını engeller.
Venice API'sinin Fiyatlandırma ve Ödeme Seçenekleri
Venice, kullanım alışkanlıklarınıza uygun üç ödeme yöntemi sunar. Pro abonelik aylık 18 dolardır ve 10 dolarlık API kredisi ile tüketici özelliklerinde sınırsız istem içerir. DIEM stake etme, sürekli günlük işlem tahsisleri sağlayan VVV tokenları satın almayı gerektirir—öngörülebilir trafiğe sahip yüksek hacimli uygulamalar için idealdir. USD kullandıkça öde, hesabınıza dolar yüklemenize ve gerektiğinde kredi tüketmenize olanak tanır, deneyler ve değişken iş yükleri için mükemmeldir.
API erişimi beta süresince şu anda ücretsiz kalacaktır. Bu, bir ödeme yöntemine karar vermeden önce entegrasyon modellerini doğrulamanıza ve maliyetleri tahmin etmenize olanak tanır. Uç noktalar ve modeller genelindeki token tüketimini izlemek için kullanım kontrol panelinizi takip edin.
Model Seçim Kılavuzları
Yetenek gereksinimleri ve gecikme kısıtlamalarına göre modelleri seçin. Prototipleme ve basit sorgular için qwen3-4b ile başlayın—hızlı yanıt verir ve çoğu metin oluşturma görevini yeterince iyi halleder. Gelişmiş muhakeme, kod oluşturma veya karmaşık talimat takibi gerektiğinde llama-3.3-70b veya deepseek-ai-DeepSeek-R1 gibi daha büyük modellere geçin. Görüş görevleri qwen3-vl-235b-a22b gibi çok modlu modeller gerektirir. Ses üretimi özel konuşma modellerini kullanır. Gerçek zamanlı kullanılabilirliği kontrol etmek için /api/v1/models uç noktasını programatik olarak sorgulayın—Venice, modelleri talep ve altyapı kapasitesine göre döndürür.
Sonuç
Venice API, yapay zeka entegrasyonundaki sürtünmeyi ortadan kaldırır. Bağlı kalma derdi olmadan OpenAI uyumluluğu, yapılandırma karmaşıklığı olmadan gizlilik ve sürpriz faturalar olmadan esnek fiyatlandırma elde edersiniz. Tak-çalıştır yerine geçme yaklaşımı, uygulama kodunu yeniden yazmadan Venice'i mevcut sağlayıcınızla birlikte değerlendirebileceğiniz anlamına gelir.
API entegrasyonları oluştururken—Venice uç noktalarını test ederken, kimlik doğrulama akışlarında hata ayıklarken veya birden fazla sağlayıcı yapılandırmasını yönetirken—iş akışınızı kolaylaştırmak için Apidog'u kullanın. Görsel API testini, dokümantasyon oluşturmayı ve ekip işbirliğini ele alır, böylece siz özelliklerin yayınlanmasına odaklanabilirsiniz.