Dokumentasi
Panduan lengkap Vantenza AI
Semua yang Anda butuhkan untuk memakai API key Vantenza AI: dari membeli kuota, menghubungkan ke aplikasi, sampai contoh prompt untuk pekerjaan Anda.
Apa itu Vantenza AI?
Vantenza AI adalah layanan AI (kecerdasan buatan) yang bisa membantu menulis, merangkum, menerjemahkan, menganalisis data, sampai membuat kode, dalam bahasa Indonesia maupun bahasa lain.
Bayar sesuai kebutuhan
Tidak ada langganan bulanan. Anda membeli kuota sekali, lalu memakainya sampai habis.
Tanpa kartu kredit
Pembayaran lewat iPaymu di commerce.vantenza.com (QRIS, e-wallet, virtual account, dan lainnya).
Teks, gambar, video & file
Kirim pertanyaan, foto, video, atau dokumen PDF, lalu pakai di aplikasi chat, Google Sheets, atau program Anda dengan satu API key.
Mulai dari sini
Ikuti tiga langkah ini secara berurutan. Setiap langkah punya panduan lengkap di bawah.
- 1
Dapatkan API key
Daftar atau masuk di commerce.vantenza.com, lalu beli kuota. API key langsung tersimpan di akun Anda.
Beli kuota - 2
Pakai AI
Masukkan API key ke aplikasi chat, Google Sheets, atau program Anda, lalu mulai bertanya.
Lihat cara pakai - 3
Pantau & top up
Lihat sisa kuota dan pemakaian di dashboard akun Anda, lalu top up key yang sama saat kuota menipis.
Buka dashboard
1. Dapatkan API key
API key dibuat di akun Anda di commerce.vantenza.com begitu pembelian kuota pertama Anda dibayar.
- 1Daftar akun di commerce.vantenza.com dengan email dan kata sandi, atau masuk jika sudah punya akun.
- 2Klik "Beli kuota", pilih nominal dan "Key baru", lalu bayar di halaman iPaymu dengan QRIS, e-wallet, atau virtual account.
- 3Setelah pembayaran terkonfirmasi, buka https://commerce.vantenza.com/id/account/ai. API key baru Anda ada di sana, lengkap dengan kuotanya.
- 4Klik "Tampilkan key", masukkan lagi kata sandi akun Anda, lalu salin key itu. Base URL dan nama model ada di bagian "Detail akses" di bawah.
- 5Simpan API key di tempat aman. Anda bisa menampilkannya lagi kapan saja dari dashboard.
2. Cara pakai paling mudah
Belum pernah memakai API? Tidak masalah. Cara paling mudah adalah memakai aplikasi chat AI yang mendukung "OpenAI API", lalu mengisi tiga data: Base URL, API key dari dashboard akun Anda, dan nama model.
- 1Pasang aplikasi chat AI yang punya pengaturan "OpenAI API Compatible" / "Custom API" (tersedia untuk Windows, Mac, Android, dan iPhone).
- 2Buka menu Pengaturan / Settings di aplikasi tersebut, lalu pilih penyedia (provider) "OpenAI API Compatible" atau "Custom".
- 3Isi API Host / Base URL dengan: https://api.vantenza.com
- 4Isi API Key dengan API key dari dashboard akun Anda.
- 5Isi Model dengan: Vantenza-V2.6 (atau model lain di bagian "Pilihan model")
- 6Simpan, lalu ketik pertanyaan pertama Anda, misalnya "Halo, apa yang bisa kamu bantu?"
Provider : OpenAI API Compatible
Base URL : https://api.vantenza.com
API Key : vt-API-KEY-ANDA
Model : Vantenza-V2.6Lebih sering bekerja di spreadsheet? Gunakan fungsi =VANTENZA() di Google Sheets. Panduan langkah demi langkahnya ada di bagian "Semua cara menghubungkan" → Google Sheets.
Lihat panduan Google Sheets3. Pantau kuota & top up
Kuota berkurang setiap kali Anda memakai AI. Pantau sisanya dan tambah kuota dari dashboard akun Anda.
- 1Masuk ke akun Anda, lalu buka https://commerce.vantenza.com/id/account/ai.
- 2Lihat total kuota, kuota terpakai, dan sisa kuota (dalam rupiah) setiap API key.
- 3Klik "Lihat pemakaian" untuk melihat biaya, jumlah permintaan, dan token per hari dan per model.
- 4Kuota menipis? Klik "Top up" pada key itu. Kuota bertambah dan API key tetap sama, jadi aplikasi Anda tidak perlu diubah.
- 5Butuh key terpisah, misalnya untuk aplikasi lain? Beli key baru. "Tampilkan key", "Ganti key", dan "Cabut key" meminta kata sandi akun Anda.
Detail akses
Gunakan nilai berikut di aplikasi atau kode apa pun yang mendukung format OpenAI.
curl https://api.vantenza.com/chat/completions \
-H "Authorization: Bearer vt-API-KEY-ANDA" \
-H "Content-Type: application/json" \
-d '{
"model": "Vantenza-V2.6",
"messages": [
{"role": "system", "content": "Kamu asisten yang menjawab singkat dalam bahasa Indonesia."},
{"role": "user", "content": "Jelaskan apa itu inflasi dalam 2 kalimat."}
]
}'Pilihan model
Satu API key bisa memakai semua model di bawah. Cukup ganti nama model di aplikasi Anda. Daftar ini selalu menampilkan model yang sedang aktif.
Chat
Paling hemat dan tercepat. Cocok untuk chat, livechat, Google Sheets, dan membaca gambar.
Seimbang antara kualitas dan harga. Cocok untuk pemakaian umum, coding, gambar, video, dan dokumen.
Paling pintar. Cocok untuk coding kompleks, agent, dan analisis berat.
Berpikir bertahap. Cocok untuk matematika, logika, dan coding yang butuh penalaran, lebih hemat dari Pro.
Model khusus
Mengubah teks jadi vektor untuk pencarian dan RAG.
Membuat gambar dari teks.
Mengubah teks jadi suara.
Mengubah rekaman suara jadi teks.
Ganti nama model di aplikasi Anda untuk memakai model lain. Model yang lebih pintar memakai kuota lebih cepat.
Model selain chat dipakai lewat endpoint masing-masing, dengan kuota yang sama. Lihat contohnya
Semua cara menghubungkan
Pilih cara yang paling sesuai. Semua cara memakai Base URL, model, dan API key yang sama. Jika Anda bukan programmer, mulai dari "Aplikasi chat & plugin" atau "Google Sheets".
cURL (terminal)
Kirim satu request langsung dari Terminal (macOS/Linux) atau PowerShell/Git Bash (Windows). Cocok untuk memastikan API key sudah aktif.
Langkah
- 1Salin perintah di bawah.
- 2Ganti vt-API-KEY-ANDA dengan API key dari dashboard akun Anda.
- 3Jalankan di terminal. Jawaban AI ada di choices[0].message.content.
curl https://api.vantenza.com/chat/completions \
-H "Authorization: Bearer vt-API-KEY-ANDA" \
-H "Content-Type: application/json" \
-d '{
"model": "Vantenza-V2.6",
"messages": [
{"role": "system", "content": "Kamu asisten yang menjawab singkat dalam bahasa Indonesia."},
{"role": "user", "content": "Jelaskan apa itu inflasi dalam 2 kalimat."}
]
}'Fitur API lainnya
Selain chat, API key yang sama bisa dipakai untuk embedding, membuat gambar, teks ke suara, suara ke teks, dan cek saldo. Semua pemakaian memotong kuota rupiah yang sama. Contoh di bawah memakai model yang sedang aktif.
Daftar endpoint
Chat: 3 format
Semua model chat bisa dipanggil lewat tiga format: OpenAI Chat Completions (contohnya di bagian "Semua cara menghubungkan"), OpenAI Responses, dan Anthropic Messages. Pilih yang cocok dengan library Anda; hasil dan kuotanya sama.
Langkah
- 1Chat Completions: https://api.vantenza.com/v1/chat/completions. Format paling umum, dipakai hampir semua aplikasi.
- 2Responses: https://api.vantenza.com/v1/responses. Jawaban ada di output[].content[].text.
- 3Messages (format Anthropic): https://api.vantenza.com/v1/messages. API key boleh dikirim di header x-api-key atau Authorization: Bearer. Jawaban ada di content[0].text.
- 4Ganti vt-API-KEY-ANDA dengan API key Anda, lalu jalankan di terminal.
curl https://api.vantenza.com/v1/responses \
-H "Authorization: Bearer vt-API-KEY-ANDA" \
-H "Content-Type: application/json" \
-d '{
"model": "Vantenza-V2.6",
"input": "Jelaskan apa itu inflasi dalam 2 kalimat."
}'Panduan per pekerjaan
Contoh pemakaian dan prompt siap pakai untuk berbagai pekerjaan. Klik "Salin" lalu ganti bagian dalam [kurung siku].
Programmer
Tambahkan kemampuan AI ke aplikasi, percepat coding, dan otomasi pekerjaan rutin.
Bisa dipakai untuk
- Membuat fitur AI di aplikasi: chatbot, ringkasan otomatis, klasifikasi tiket, ekstraksi data.
- Menjelaskan, mereview, dan merapikan kode.
- Membuat unit test, dokumentasi, dan pesan commit.
- Menulis query SQL dan regex dari deskripsi bahasa biasa.
- Mengubah teks bebas menjadi JSON terstruktur.
Cara yang disarankan
Tips
- Gunakan pesan role "system" untuk menetapkan peran dan format jawaban secara konsisten.
- Minta format terstruktur ("jawab hanya JSON") agar hasilnya mudah diproses program.
- Panjang jawaban per request dibatasi sesuai model (lihat "Pilihan model"). Untuk hasil panjang, pecah menjadi beberapa request.
- Simpan API key di environment variable atau secret manager, jangan di repository.
Contoh prompt
Kamu senior software engineer. Review kode berikut: cari bug, masalah keamanan, dan bagian yang bisa disederhanakan. Tampilkan dalam daftar bernomor beserta perbaikannya. ``` [tempel kode] ```
Buat unit test lengkap (kasus normal, batas, dan error) untuk fungsi berikut menggunakan [pytest / Jest / PHPUnit]. Sertakan penjelasan singkat tiap test. ``` [tempel fungsi] ```
Ekstrak data dari teks berikut ke JSON dengan field: nama, email, telepon, kota. Isi null jika tidak ada. Jawab HANYA dengan JSON yang valid. Teks: [tempel teks]
Tabel: orders(id, customer_id, total, created_at), customers(id, name, city). Tulis query PostgreSQL untuk menampilkan 10 kota dengan total penjualan terbesar bulan lalu, lalu jelaskan singkat cara kerjanya.
Buat pesan commit dengan format Conventional Commits (maksimal 72 karakter untuk judul) dari perubahan berikut: [tempel git diff]
Kuota & token
Pahami cara kuota dihitung agar pemakaian lebih hemat.
Kuota dalam rupiah
Kuota API key sama dengan nominal yang Anda bayar. Setiap request mengurangi kuota sesuai jumlah token yang diproses.
Apa itu token?
Token adalah potongan kata. Kira-kira 1 token ≈ 4 karakter bahasa Inggris; bahasa Indonesia biasanya sedikit lebih banyak token per kata.
Input & output
Input adalah semua teks yang Anda kirim (termasuk riwayat percakapan). Output adalah jawaban AI. Token output lebih mahal, jadi minta jawaban yang ringkas bila memungkinkan.
Batas per request
Setiap model punya batas panjang jawaban dan ukuran request sendiri (lihat "Pilihan model"). Gambar, video, dan file ikut dihitung sebagai token input.
Tips hemat kuota
- Minta jawaban singkat dan spesifik, misalnya "maksimal 3 poin" atau "jawab satu kata".
- Kirim hanya bagian dokumen yang relevan, bukan seluruh dokumen.
- Batasi riwayat percakapan: kirim beberapa pesan terakhir saja.
- Simpan (cache) jawaban untuk pertanyaan yang sama agar tidak dikirim berulang.
Tips menulis prompt
Kualitas jawaban sangat bergantung pada cara Anda bertanya. Gunakan pola berikut.
Beri peran
Awali dengan peran AI, misalnya "Kamu akuntan berpengalaman".
Jelaskan konteks
Sebutkan tujuan, audiens, dan informasi latar yang relevan.
Tentukan format
Minta bentuk jawaban: poin, tabel, JSON, atau jumlah kata tertentu.
Beri contoh
Satu atau dua contoh hasil yang diinginkan membuat jawaban jauh lebih konsisten.
Pecah tugas besar
Minta outline dulu, lalu kembangkan per bagian.
Iterasi
Perbaiki dengan pesan lanjutan: "lebih singkat", "lebih formal", "tambahkan contoh".
Template prompt
Peran : Kamu [peran, misalnya analis keuangan berpengalaman].
Konteks : [latar belakang dan tujuan].
Tugas : [apa yang harus dikerjakan].
Format : [poin / tabel / JSON / maksimal N kata].
Data :
[tempel data atau teks di sini]Buatkan caption.
Kamu copywriter media sosial. Buat 3 caption Instagram (maks. 30 kata, gaya santai) untuk promo diskon 20% kopi susu gula aren, target mahasiswa. Akhiri dengan ajakan membeli.
Kalau ada error
Jika request gagal, API mengembalikan status HTTP dan pesan error dalam format berikut:
{
"error": {
"message": "Your quota has been used up. Please purchase more quota.",
"type": "insufficient_quota",
"code": "quota_exhausted"
}
}| Status | Pesan | Penyebab | Solusi |
|---|---|---|---|
| 401 | API key salah, tidak lengkap, tidak dikirim, atau sudah diganti atau dicabut. | Salin ulang API key dari dashboard akun Anda. Pastikan header berformat "Authorization: Bearer <API key>". | |
| 429 | Kuota API key sudah habis. | Cek sisa kuota di https://commerce.vantenza.com/id/account/ai, lalu top up key yang sama. API key-nya tidak berubah. | |
| 429 | Terlalu banyak request dalam waktu singkat. | Tunggu beberapa detik lalu coba lagi. Untuk program, beri jeda dan coba ulang otomatis (retry dengan backoff). | |
| 413 | Isi request (teks, riwayat percakapan, gambar, video, file) melebihi batas model. | Kecilkan atau kompres file, kirim dokumen per bagian, kurangi riwayat percakapan, atau pakai model dengan batas lebih besar. | |
| 400 | Nama model salah, atau model tersebut sedang tidak aktif. | Gunakan nama dari bagian "Pilihan model", misalnya "Vantenza-V2.6". Nama model peka huruf besar/kecil. | |
| 404 | Alamat endpoint salah. | Gunakan https://api.vantenza.com/chat/completions (atau Base URL https://api.vantenza.com pada library). | |
| 500 / 503 | Gangguan sementara di server. | Coba lagi beberapa saat. Jika berlanjut, hubungi cs@vantenza.com. |
Keamanan
API key sama seperti password: siapa pun yang memilikinya bisa memakai kuota Anda.
- Jangan bagikan API key ke orang lain atau di grup chat.
- Jangan menaruh API key di kode yang berjalan di browser, aplikasi mobile, atau repository publik.
- Simpan API key di environment variable, secret manager, atau Properti skrip (Google Sheets).
- Jika API key bocor, segera pakai "Ganti key" di dashboard: key lama langsung berhenti bekerja, kuotanya tetap. Butuh bantuan? Hubungi cs@vantenza.com.
- Jangan mengirim data sensitif (password, nomor kartu, data pribadi orang lain) ke AI.
- Jawaban AI bisa keliru. Periksa kembali fakta, angka, dan kode sebelum dipakai.
Kamus istilah
Istilah yang sering muncul, dijelaskan dengan bahasa sehari-hari.
- Top up
- Menambah kuota ke API key yang sudah ada. Key-nya tetap sama, jadi aplikasi Anda tidak perlu diubah.
- API key
- Kunci pribadi (seperti password) yang membuat AI mengenali Anda dan memotong kuota Anda. Jangan dibagikan.
- Base URL
- Alamat server Vantenza AI yang dimasukkan ke aplikasi, yaitu https://api.vantenza.com.
- Model
- Nama "otak" AI yang dipakai, misalnya Vantenza-V2.6. Pilihan lengkapnya ada di bagian "Pilihan model".
- Prompt
- Perintah atau pertanyaan yang Anda ketik untuk AI.
- Token
- Satuan potongan kata yang dihitung AI. Semakin panjang teks, semakin banyak token yang dipakai.
- Kuota
- Saldo pemakaian Anda (dalam rupiah) yang berkurang sesuai jumlah token yang dipakai.
- Endpoint
- Alamat lengkap untuk mengirim pertanyaan lewat program: https://api.vantenza.com/chat/completions.
FAQ
Pertanyaan yang sering diajukan.
Apa itu API key, dan untuk apa?
API key adalah kode rahasia yang menjadi tanda pengenal Anda saat sebuah aplikasi memakai AI. Tempelkan di aplikasi chat, Google Sheets, atau kode Anda bersama Base URL dan nama model, lalu setiap pemakaian dihitung dari kuota Anda. Simpan baik-baik dan jangan bagikan ke orang lain.
Bagaimana cara mendapatkan API key?
Daftar atau masuk di commerce.vantenza.com, lalu beli kuota Vantenza AI. Setelah pembayaran terkonfirmasi, API key tampil di dashboard akun Anda (https://commerce.vantenza.com/id/account/ai) beserta kuotanya.
API key saya hilang. Bagaimana melihatnya lagi?
Masuk ke akun Anda, buka https://commerce.vantenza.com/id/account/ai, lalu klik "Tampilkan key" dan masukkan kata sandi akun Anda. Jika key mungkin bocor, pakai "Ganti key": key lama berhenti bekerja, kuotanya tetap.
Bagaimana cara mengecek sisa kuota?
Buka https://commerce.vantenza.com/id/account/ai. Sisa kuota tampil dalam rupiah, dan "Lihat pemakaian" menunjukkan biaya, jumlah permintaan, dan token per hari dan per model.
Apa itu token AI, dan berapa banyak yang bisa saya pakai dengan kuota saya?
Kuota dihitung dari jumlah token (potongan kata) yang diproses: teks yang Anda kirim (input) dan jawaban AI (output). Jawaban lebih mahal daripada input. Token yang sudah terpakai tampil per hari dan per model di dashboard akun Anda.
Apa yang terjadi saat kuota habis?
Request berikutnya akan ditolak dengan pesan "Your quota has been used up". Top up key yang sama untuk melanjutkan; API key-nya tidak berubah.
Apakah kuota punya masa berlaku?
Kuota tidak berkurang jika tidak dipakai. Hubungi cs@vantenza.com jika ada pertanyaan tentang ketentuan pembelian.
Apakah satu API key bisa dipakai di beberapa aplikasi?
Bisa. Semua pemakaian akan mengurangi kuota yang sama. Jangan bagikan API key ke orang lain.
Apakah AI mengingat percakapan sebelumnya?
Tidak. Setiap request berdiri sendiri. Untuk percakapan berlanjut, kirim ulang riwayat pesan sebelumnya dalam array messages (lihat contoh "Percakapan" di bagian Python). Aplikasi chat biasanya melakukannya otomatis.
Kenapa jawaban AI terpotong?
Setiap model punya batas panjang jawaban (lihat "Pilihan model"). Jika terpotong (finish_reason = "length"), minta AI melanjutkan dengan pesan "lanjutkan", atau pecah tugas menjadi beberapa bagian.
Apakah bisa mengirim gambar, video, atau file?
Bisa. Kirim foto, video, atau dokumen PDF bersama pertanyaan Anda (contoh ada di tab "Gambar, video & file"). Jenis input dan ukuran maksimal tiap model tertera di bagian "Pilihan model". Membuat gambar dan suara tersedia lewat endpoint API tersendiri (lihat bagian "Fitur API lainnya" di panduan); membuat video belum didukung.
Model mana yang sebaiknya saya pakai?
Mulai dari model default. Pakai model "Lite" untuk chat ringan dan volume besar supaya hemat, dan model yang lebih pintar untuk coding atau analisis yang rumit. Semua model memakai kuota yang sama; model yang lebih pintar menghabiskannya lebih cepat.
Apakah data saya aman?
Hindari mengirim data sensitif seperti password, nomor kartu, nomor rekening lengkap, atau data pribadi orang lain. Anonimkan data sebelum dikirim.
Butuh bantuan? Hubungics@vantenza.com