Panduan cepat untuk pipa Vibevoice
Dapatkan output teks mentah tanpa sensor dari VibeVoice dalam hitungan detik. Panduan cepat ini menunjukkan cara mengintegrasikan api kompatibel openai kami ke dalam pipa Anda menggunakan SDK standar.
Prasyarat
Sebelum mengintegrasikan, pastikan Anda memiliki akun aktif. Daftar melalui Google atau email di halaman Dapatkan kunci API untuk menerima kunci unik Anda secara instan. Anda tidak memerlukan kartu kredit untuk uji coba awal $0.50. LLM tanpa sensor kami melayani model id "uncensored" melalui endpoint standar. URL dasar adalah https://api.vibevoice.top/v1. Pengaturan ini kompatibel dengan SDK OpenAI apa pun, menjadikannya pengganti langsung bagi banyak pipeline yang ada.
Autentikasi
Masukkan kunci API Anda dalam header Authorization. Formatnya harus "Bearer YOUR_API_KEY". Jika kunci hilang atau tidak valid, API mengembalikan error 401. Karena kami berfokus pada pemrosesan teks, pastikan pipa Anda hanya mengirim data teks. Kunci terkait dengan satu akun; menghasilkan kunci baru menggantikan kunci lama secara instan. Kesederhanaan ini memungkinkan iterasi cepat di lingkungan pengembangan Anda.
Mengirim Permintaan
Buat permintaan POST ke /v1/chat/completions. Sertakan id model, pesan Anda, dan parameter apa pun. Berikut adalah contoh dasar menggunakan cURL:
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."}]
}'Permintaan ini mengirimkan instruksi sederhana ke model. Respons berisi teks yang dihasilkan. Anda dapat menyesuaikan parameter seperti temperature untuk kreativitas atau menetapkan batas ketat pada panjang output. Pendekatan langsung ini sangat ideal untuk menghasilkan skrip, caption, atau variasi prompt untuk alat lain.
Integrasi SDK Python
Gunakan pustaka Python OpenAI resmi. Konfigurasikan URL dasar untuk mengarah ke layanan kami. Masukkan kunci API Anda sebagai api_key. Ini memungkinkan Anda menggunakan metode yang sudah dikenal seperti client.chat.completions.create(). Ini adalah api kompatibel openai, sehingga struktur kode Anda yang ada kemungkinan memerlukan perubahan minimal. Metode ini sangat cocok untuk pemrosesan backend atau tugas ekstraksi data.
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)Ingatlah untuk menangani pengecualian dengan baik. Error jaringan atau batas laju dapat mengganggu pipa Anda. Mencatat respons membantu dalam debugging mengapa prompt tertentu mungkin ditolak atau menghasilkan output yang tidak terduga.
Integrasi SDK Node
Untuk lingkungan JavaScript, gunakan paket npm openai. Tetapkan properti apiKey dan baseURL dalam objek konfigurasi. Ini memastikan permintaan dikirim ke endpoint yang benar. SDK Node mendukung parameter yang sama dengan versi Python. Ini sangat ideal untuk server web atau fungsi tepi yang perlu menghasilkan teks sesuai permintaan.
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);Pastikan Anda mengelola siklus hidup objek klien untuk menghindari kebocoran sumber daya. Integrasi ini kuat untuk menangani tugas generasi teks asinkron dalam aplikasi web modern.
Respons Streaming
Aktifkan streaming dengan mengatur stream menjadi true dalam permintaan Anda. API mengembalikan data dalam potongan saat dihasilkan. Ini berguna untuk tampilan waktu nyata atau rendering teks progresif. Potongan terakhir mencakup statistik penggunaan token lengkap. Streaming mengurangi latensi yang dirasakan bagi pengguna akhir.
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)Kelola stream dengan benar untuk memastikan semua data diproses. Jika koneksi terputus, Anda mungkin kehilangan data penggunaan akhir. Fitur ini sangat berharga untuk aplikasi yang perlu menampilkan teks saat sedang ditulis.
Spesifikasi teknis
Semua batas dan fitur API yang sebenarnya di satu tempat — cek dulu sebelum isi saldo.
| Item | Nilai |
|---|---|
| Format | kompatibel OpenAI: SDK OpenAI apa pun bisa dipakai, cukup ganti base URL dan kunci |
| Autentikasi | Authorization: Bearer YOUR_KEY |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| ID model | uncensored |
| Base URL | https://api.vibevoice.top/v1 |
| Mode JSON | response_format: {"type": "json_object"} |
| Function calling | ya — tools, tool_choice; balasan berisi tool_calls, juga saat streaming; hasil dikirim sebagai role: tool |
| Jendela konteks | 64.000 token (input + output) |
| Parameter | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Output maksimal | hingga sisa jendela 64.000 token; max_tokens opsional (tanpa batas terpisah) |
| Streaming | ya — server-sent events; potongan terakhir berisi penggunaan token |
| Batas laju | 300 permintaan per menit per kunci |
| Ukuran permintaan | hingga 8 MB |
| Konkurensi | 8 permintaan bersamaan per kunci |
| Header respons | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Uji coba gratis | $0,50 selama 7 hari, tanpa kartu · Kunci uji coba: 2 permintaan paralel, 60 per menit; batas penuh (8 dan 300) setelah isi saldo pertama |
| Isi saldo | USDT (TRC20) atau USDC (Base), nominal bulat berapa pun dari $10 sampai $500 |
| Bonus | +5% mulai $50, +10% mulai $100 |
| Masa berlaku | saldo berbayar tidak kedaluwarsa, tanpa langganan |
| Harga | $0,25 per 1 juta token input · $1,00 per 1 juta token output |
| Penagihan | saldo prabayar sesuai pemakaian nyata; error dan penolakan gratis |
| Konten | konten dewasa diizinkan; konten seksual yang melibatkan anak di bawah umur ditolak |
| Kunci | satu kunci aktif per akun; kunci baru menggantikan yang lama |
| Masuk | Google atau email dan kata sandi |
Kode error
Error dikirim sebagai JSON dengan type tetap; permintaan gagal atau ditolak tidak ditagih.
| Kode | Tipe | Arti |
|---|---|---|
400 | bad_request | JSON tidak valid, pesan kosong, parameter salah, atau konteks terlalu panjang |
401 | missing_key · invalid_key · key_revoked | kunci tidak ada, salah, atau sudah diganti |
402 | no_credit | saldo habis — isi ulang dan lanjut seketika |
403 | content_blocked | konten seksual dengan anak di bawah umur — ditolak, tidak ditagih |
404 | not_found | endpoint tidak dikenal |
413 | request_too_large | body lebih dari 8 MB |
429 | rate_limited · concurrency | lebih dari 300/menit atau 8 paralel — tunggu lalu coba lagi |
503 | upstream_busy | model sibuk — coba lagi beberapa detik lagi |
Tanya jawab
Berapa batas laju?
Anda dibatasi hingga 300 permintaan per menit per kunci dan 8 permintaan simultan. Badan permintaan tidak boleh melebihi 8 MB. Melampaui batas ini menghasilkan error 429.
Bagaimana cara kerja harga?
Anda membayar $0.25 per 1M token input dan $1.00 per 1M token output. Saldo prabayar diisi ulang melalui kripto (USDT atau USDC) dan tidak pernah kedaluwarsa. Error dan penolakan gratis.
Apa itu jendela konteks?
Jendela konteks total adalah 100,000 token untuk prompt dan completion gabungan. Output maksimum per permintaan adalah 32,000 token, atau 2,048 jika max_tokens tidak ditentukan.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh pengaturannya.