ID
Beli kuota
Dokumentasi

Panduan lengkap Vantenza AI

Semua yang Anda butuhkan untuk memakai API key Vantenza AI: dari redeem, 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 toko Vantenza di Lynk.id (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. 1

    Redeem kode

    Setelah membeli, Anda menerima redeem code lewat email. Tukarkan kode itu untuk mendapatkan API key.

    Buka redeem
  2. 2

    Pakai AI

    Masukkan API key ke aplikasi chat, Google Sheets, atau program Anda, lalu mulai bertanya.

    Lihat cara pakai
  3. 3

    Cek sisa kuota

    Pantau sisa kuota dan jumlah pemakaian kapan saja dengan memasukkan API key Anda.

    Cek pemakaian

1. Redeem kode

Redeem code adalah kode yang dikirim ke email Anda setelah pembayaran berhasil. Tukarkan kode ini untuk mendapatkan API key.

  1. 1Buka email dari Vantenza Store dengan judul "Kode Redeem Pesanan …". Jika tidak ada di Kotak Masuk, cek folder Spam atau Promosi.
  2. 2Klik tombol "Redeem sekarang" di email. Halaman redeem akan terbuka dengan kode yang sudah terisi.
  3. 3Atau buka https://ai.vantenza.com/id/redeem secara manual, lalu ketik redeem code (formatnya AIRS-XXXX-XXXX-XXXX).
  4. 4Klik "Redeem sekarang". Detail akses Anda langsung tampil: API Key, Base URL, dan Model.
  5. 5Klik "Salin semua" lalu simpan di tempat aman (misalnya aplikasi catatan pribadi). Anda juga bisa membuka halaman redeem lagi kapan saja dengan kode yang sama.
Buka halaman redeem

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 dari halaman redeem.

  1. 1Pasang aplikasi chat AI yang punya pengaturan "OpenAI API Compatible" / "Custom API" (tersedia untuk Windows, Mac, Android, dan iPhone).
  2. 2Buka menu Pengaturan / Settings di aplikasi tersebut, lalu pilih penyedia (provider) "OpenAI API Compatible" atau "Custom".
  3. 3Isi API Host / Base URL dengan: https://api.vantenza.com
  4. 4Isi API Key dengan API key dari halaman redeem.
  5. 5Isi Model dengan: Vantenza-V2.6 (atau model lain di bagian "Pilihan model")
  6. 6Simpan, lalu ketik pertanyaan pertama Anda, misalnya "Halo, apa yang bisa kamu bantu?"
text
Provider : OpenAI API Compatible
Base URL : https://api.vantenza.com
API Key  : vt-API-KEY-ANDA
Model    : Vantenza-V2.6

Lebih 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 Sheets

3. Cek sisa kuota

Kuota berkurang setiap kali Anda memakai AI. Cek sisanya kapan saja, gratis.

  1. 1Buka https://ai.vantenza.com/id/usage.
  2. 2Tempel API key Anda di kolom yang tersedia, lalu klik "Cek pemakaian".
  3. 3Lihat sisa kuota (dalam rupiah), jumlah token terpakai, dan perkiraan sisa token.
  4. 4Klik "Perbarui" untuk melihat angka terbaru. Data diperbarui sekitar setiap menit.
Buka cek pemakaian

Detail akses

Gunakan nilai berikut di aplikasi atau kode apa pun yang mendukung format OpenAI.

Base URLhttps://api.vantenza.com
Beberapa aplikasi meminta akhiran /v1; keduanya didukung.
Endpoint chathttps://api.vantenza.com/chat/completions
Method POST, format OpenAI Chat Completions.
ModelVantenza-V2.6
Model default. Model lain ada di bagian "Pilihan model".
API keyvt-API-KEY-ANDA
Dari halaman redeem. Kirim di header Authorization: Bearer <API key>.
Cek pemakaianhttps://ai.vantenza.com/id/usage
Sisa kuota dalam rupiah dan token terpakai.
bash
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

Vantenza-V2.6-Lite

Paling hemat dan tercepat. Cocok untuk chat, livechat, Google Sheets, dan membaca gambar.

teksgambarvideofile
Jawaban maks. 32.768 tokenUkuran request maks. 20 MB
Vantenza-V2.6
Default

Seimbang antara kualitas dan harga. Cocok untuk pemakaian umum, coding, gambar, video, dan dokumen.

teksgambarvideofile
Jawaban maks. 32.768 tokenUkuran request maks. 20 MB
Vantenza-V2.6-Pro

Paling pintar. Cocok untuk coding kompleks, agent, dan analisis berat.

teksgambarfile
Jawaban maks. 32.768 tokenUkuran request maks. 20 MB
Vantenza-V2.6-Reasoning

Berpikir bertahap. Cocok untuk matematika, logika, dan coding yang butuh penalaran, lebih hemat dari Pro.

teks
Jawaban maks. 32.768 tokenUkuran request maks. 4 MB

Model khusus

Vantenza-Embed
Embedding (pencarian teks)

Mengubah teks jadi vektor untuk pencarian dan RAG.

teks
Ukuran request maks. 4 MB
Vantenza-Image
Membuat gambar

Membuat gambar dari teks.

teks
Ukuran request maks. 4 MB
Vantenza-Voice
Teks ke suara

Mengubah teks jadi suara.

teks
Ukuran request maks. 1 MB
Vantenza-Transcribe
Suara ke teks

Mengubah rekaman suara jadi teks.

audio
Ukuran request maks. 20 MB

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".

Cara tercepat menguji API key dari terminal.

cURL (terminal)

Kirim satu request langsung dari Terminal (macOS/Linux) atau PowerShell/Git Bash (Windows). Cocok untuk memastikan API key sudah aktif.

Langkah

  1. 1Salin perintah di bawah.
  2. 2Ganti vt-API-KEY-ANDA dengan API key dari halaman redeem.
  3. 3Jalankan di terminal. Jawaban AI ada di choices[0].message.content.
bash
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

Untuk programmer yang memakai library atau alat dengan format berbeda.

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

  1. 1Chat Completions: https://api.vantenza.com/v1/chat/completions. Format paling umum, dipakai hampir semua aplikasi.
  2. 2Responses: https://api.vantenza.com/v1/responses. Jawaban ada di output[].content[].text.
  3. 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.
  4. 4Ganti vt-API-KEY-ANDA dengan API key Anda, lalu jalankan di terminal.
bash
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

PythonJavaScript / Node.jsPHP / LaravelcURL (terminal)Aplikasi chat & plugin

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

Review kode

Kamu senior software engineer. Review kode berikut: cari bug, masalah keamanan, dan bagian yang bisa disederhanakan. Tampilkan dalam daftar bernomor beserta perbaikannya. ``` [tempel kode] ```

Unit test

Buat unit test lengkap (kasus normal, batas, dan error) untuk fungsi berikut menggunakan [pytest / Jest / PHPUnit]. Sertakan penjelasan singkat tiap test. ``` [tempel fungsi] ```

Teks ke JSON

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]

Query SQL

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.

Pesan commit

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

text
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]
✗ Kurang jelas

Buatkan caption.

✓ Jelas

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:

json
{
  "error": {
    "message": "Your quota has been used up. Please purchase more quota.",
    "type": "insufficient_quota",
    "code": "quota_exhausted"
  }
}
StatusPesanPenyebabSolusi
401Invalid API key.API key salah, tidak lengkap, atau tidak dikirim.Salin ulang API key dari halaman redeem. Pastikan header berformat "Authorization: Bearer <API key>".
429Your quota has been used up. Please purchase more quota.Kuota API key sudah habis.Cek sisa kuota di https://ai.vantenza.com/id/usage. Beli kuota lagi untuk mendapatkan API key baru.
429The service is busy. Please retry in a moment.Terlalu banyak request dalam waktu singkat.Tunggu beberapa detik lalu coba lagi. Untuk program, beri jeda dan coba ulang otomatis (retry dengan backoff).
413Request is too large for this model (max …).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.
400Invalid model name passed in model=…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.
404Not found.Alamat endpoint salah.Gunakan https://api.vantenza.com/chat/completions (atau Base URL https://api.vantenza.com pada library).
500 / 503The service is temporarily unavailable. Please retry in a moment.Gangguan sementara di server.Coba lagi beberapa saat. Jika berlanjut, hubungi [email protected].

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 hubungi [email protected].
  • 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.

Redeem code
Kode penukaran dari email setelah Anda membeli. Ditukar sekali untuk mendapatkan API key.
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.

Bagaimana cara mendapatkan API key?

Setelah pembayaran berhasil, redeem code dikirim ke email Anda. Buka https://ai.vantenza.com/id/redeem, masukkan kode tersebut, dan API key beserta detail aksesnya langsung tampil.

API key saya hilang. Bagaimana melihatnya lagi?

Buka kembali https://ai.vantenza.com/id/redeem dan masukkan redeem code yang sama dari email. API key yang sama akan ditampilkan lagi.

Bagaimana cara mengecek sisa kuota?

Buka https://ai.vantenza.com/id/usage, masukkan API key, lalu lihat sisa kuota (dalam rupiah) dan jumlah token yang terpakai. Data diperbarui sekitar setiap menit.

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. Perkiraan jumlah token untuk kuota Anda tampil di halaman Cek Pemakaian.

Apa yang terjadi saat kuota habis?

Request berikutnya akan ditolak dengan pesan "Your quota has been used up". Beli kuota lagi untuk mendapatkan redeem code dan API key baru.

Apakah kuota punya masa berlaku?

Kuota tidak berkurang jika tidak dipakai. Hubungi [email protected] 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.