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

    Dapatkan API key

    Daftar atau masuk di commerce.vantenza.com, lalu beli kuota. API key langsung tersimpan di akun Anda.

    Beli kuota
  2. 2

    Pakai AI

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

    Lihat cara pakai
  3. 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.

  1. 1Daftar akun di commerce.vantenza.com dengan email dan kata sandi, atau masuk jika sudah punya akun.
  2. 2Klik "Beli kuota", pilih nominal dan "Key baru", lalu bayar di halaman iPaymu dengan QRIS, e-wallet, atau virtual account.
  3. 3Setelah pembayaran terkonfirmasi, buka https://commerce.vantenza.com/id/account/ai. API key baru Anda ada di sana, lengkap dengan kuotanya.
  4. 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.
  5. 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.

  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 dashboard akun Anda.
  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. Pantau kuota & top up

Kuota berkurang setiap kali Anda memakai AI. Pantau sisanya dan tambah kuota dari dashboard akun Anda.

  1. 1Masuk ke akun Anda, lalu buka https://commerce.vantenza.com/id/account/ai.
  2. 2Lihat total kuota, kuota terpakai, dan sisa kuota (dalam rupiah) setiap API key.
  3. 3Klik "Lihat pemakaian" untuk melihat biaya, jumlah permintaan, dan token per hari dan per model.
  4. 4Kuota menipis? Klik "Top up" pada key itu. Kuota bertambah dan API key tetap sama, jadi aplikasi Anda tidak perlu diubah.
  5. 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.

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 dashboard akun Anda. Kirim di header Authorization: Bearer <API key>.
Dashboardhttps://commerce.vantenza.com/id/account/ai
Sisa kuota, pemakaian per hari dan model, dan top up.
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-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 dashboard akun Anda.
  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, tidak dikirim, atau sudah diganti atau dicabut.Salin ulang API key dari dashboard akun Anda. 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://commerce.vantenza.com/id/account/ai, lalu top up key yang sama. API key-nya tidak berubah.
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 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