Vibevoice boru hatları için hızlı başlangıç
VibeVoice'tan saniyeler içinde ham, sansürsüz metin çıktısı alın. Bu hızlı başlangıç, standart SDK'ları kullanarak uyumlu openai api'nizi boru hattınıza nasıl entegre edeceğinizi gösterir.
Önkoşullar
Entegrasyona başlamadan önce aktif bir hesabınız olduğundan emin olun. Benzersiz anahtarınızı hemen almak için API anahtarı sayfasında Google veya e-posta ile kaydolun. İlk $0.50 deneme kredisi için kredi kartına ihtiyacınız yoktur. Sansürsüz LLM, "uncensored" model kimliğini standart bir uç nokta üzerinden sunar. Temel URL https://api.vibevoice.top/v1.'dir. Bu yapılandırma herhangi bir OpenAI SDK ile çalışır ve mevcut birçok boru hattı için doğrudan yerini alabilir.
Kimlik Doğrulama
API anahtarınızı Authorization başlığında iletin. Format "Bearer YOUR_API_KEY" olmalıdır. Anahtar eksik veya geçersizse API 401 hatası döndürür. Metin işleme üzerine odaklandığımız için, boru hattınızın yalnızca metin verisi gönderdiğinden emin olun. Anahtar bir hesaba bağlıdır; yeni anahtar oluşturmak eski anahtarı anında değiştirir. Bu sadelik, geliştirme ortamınızda hızlı iterasyon sağlar.
İstek Gönderme
/v1/chat/completions uç noktasına POST isteği yapın. Model kimliğini, mesajlarınızı ve herhangi bir parametreyi dahil edin. İşte cURL kullanan temel bir örnek:
curl https://api.vibevoice.top/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."}]
}'Bu istek, modele basit bir talimat gönderir. Yanıt oluşturulan metni içerir. Yaratıcılık için temperature gibi parametreleri ayarlayabilir veya çıktı uzunluğu için sıkı sınırlar belirleyebilirsiniz. Bu doğrudan yaklaşım, diğer araçlar için betikler, altyazılar veya istem varyasyonları oluşturmak için idealdir.
Python SDK Entegrasyonu
Resmî OpenAI Python kitaplığını kullanın. Temel URL'yi hizmetimize işaret edecek şekilde yapılandırın. API anahtarınızı api_key olarak iletin. Bu, client.chat.completions.create() gibi tanıdık yöntemleri kullanmanızı sağlar. Bu bir openai uyumlu api olduğundan, mevcut kod yapınızda muhtemelen minimum değişiklik gerekir. Bu yöntem, arka uç işleme veya veri çıkarma görevleri için mükemmeldir.
from openai import OpenAI
client = OpenAI(base_url="https://api.vibevoice.top/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)İstisnaları zarif bir şekilde ele aldığınızdan emin olun. Ağ hataları veya hız limitleri boru hattınızı kesintiye uğratabilir. Yanıtın günlüğünü tutmak, belirli bir istemin neden reddedildiğini veya beklenmedik çıktı ürettiğini hata ayıklamaya yardımcı olur.
Node SDK Entegrasyonu
JavaScript ortamları için openai npm paketini kullanın. Yapılandırma nesnesinde apiKey ve baseURL özelliklerini ayarlayın. Bu, isteklerin doğru uç noktaya gitmesini sağlar. Node SDK, Python sürümünün aynı parametrelerini destekler. Talep üzerine metin oluşturması gereken web sunucuları veya kenar işlevleri için idealdir.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.vibevoice.top/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);Kaynak sızıntılarını önlemek için istemci nesnesinin yaşam döngüsünü yönettiğinizden emin olun. Bu entegrasyon, modern web uygulamalarında eşzamansız metin oluşturma görevlerini işlemek için sağlamdır.
Akışlı Yanıtlar
İsteğinizde stream değerini true olarak ayarlayarak akışı etkinleştirin. API, veriler oluşturuldukça parçalar halinde döndürür. Bu, gerçek zamanlı görüntülemeler veya aşamalı metin oluşturma için kullanışlıdır. Son parça, tam token kullanım istatistiklerini içerir. Akış, son kullanıcılar için algılanan gecikmeyi azaltı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)Tüm verilerin işlendiğinden emin olmak için akışı doğru şekilde yönetin. Bağlantı kesilirse, son kullanım verisini kaçırabilirsiniz. Bu özellik, metnin yazılırken görüntülenmesini gerektiren uygulamalar için değerlidir.
Teknik özellikler
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 |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Model kimliği | uncensored |
| Base URL | https://api.vibevoice.top/v1 |
| JSON modu | response_format: {"type": "json_object"} |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| Bağlam penceresi | 64.000 token (girdi + çıktı) |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Maksimum çıktı | 64.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| Hız limiti | anahtar başına dakikada 300 istek |
| İ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 |
| Ü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) |
| Yükleme | USDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10 |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Fiyat | 1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00 |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
| Giriş | Google veya e-posta ve şifre |
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
Hız limitleri nelerdir?
Anahtar başına dakikada 300 istek ve 8 eşzamanlı istekle sınırlısınız. İstek gövdesi 8 MB'ı aşmamalıdır. Bu limitlerin aşılması 429 hatasına neden olur.
Fiyatlandırma nasıl çalışır?
1M giriş tokenı başına $0,25 ve 1M çıktı tokenı başına $1,00 ödersiniz. Kredi kripto (USDT veya USDC) ile yüklenir ve süresi dolmaz. Hatalar ve reddetmeler ücretsizdir.
Bağlam penceresi nedir?
İstem ve tamamlama için toplam bağlam penceresi 100.000 token'dır. İstek başına maksimum çıktı 32.000 token veya max_tokens belirtilmediğinde 2.048 token'dır.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulumun tamamı bu kadar.