Dokumentasi
Panduan lengkap Vantenza AI
Semua yang anda perlukan untuk menggunakan API key Vantenza AI: dari membeli kuota, menyambung ke aplikasi, hingga contoh prompt untuk pekerjaan anda.
Apakah itu Vantenza AI?
Vantenza AI ialah perkhidmatan AI (kecerdasan buatan) yang boleh membantu menulis, meringkaskan, menterjemah, menganalisis data, hingga menulis kod, dalam bahasa Melayu, bahasa Indonesia mahupun bahasa lain.
Bayar ikut keperluan
Tiada langganan bulanan. Anda membeli kuota sekali, kemudian menggunakannya sampai habis.
Tanpa kad kredit
Pembayaran melalui iPaymu di commerce.vantenza.com (QRIS, e-dompet, akaun maya, dan lain-lain).
Teks, gambar, video & fail
Hantar soalan, foto, video, atau dokumen PDF, kemudian gunakan dalam aplikasi sembang, Google Sheets, atau program anda dengan satu API key.
Mula di sini
Ikuti tiga langkah ini mengikut urutan. Setiap langkah ada panduan lengkap di bawah.
- 1
Dapatkan API key
Daftar atau log masuk di commerce.vantenza.com, kemudian beli kuota. API key terus disimpan dalam akaun anda.
Beli kuota - 2
Guna AI
Masukkan API key ke dalam aplikasi sembang, Google Sheets, atau program anda, kemudian mula bertanya.
Lihat cara guna - 3
Pantau & top up
Lihat baki kuota dan penggunaan di papan pemuka akaun anda, kemudian top up key yang sama apabila kuota hampir habis.
Buka papan pemuka
1. Dapatkan API key
API key dibuat dalam akaun anda di commerce.vantenza.com sebaik sahaja pembelian kuota pertama anda dibayar.
- 1Daftar akaun di commerce.vantenza.com dengan e-mel dan kata laluan, atau log masuk jika sudah ada akaun.
- 2Klik "Beli kuota", pilih nilai dan "Key baharu", kemudian bayar di halaman iPaymu dengan QRIS, e-dompet, atau akaun maya.
- 3Selepas pembayaran disahkan, buka https://commerce.vantenza.com/ms/account/ai. API key baharu anda ada di situ, lengkap dengan kuotanya.
- 4Klik "Tunjukkan key", masukkan semula kata laluan akaun anda, kemudian salin key itu. Base URL dan nama model ada di bahagian "Butiran akses" di bawah.
- 5Simpan API key di tempat yang selamat. Anda boleh memaparkannya semula bila-bila masa dari papan pemuka.
2. Cara guna paling mudah
Belum pernah menggunakan API? Tiada masalah. Cara paling mudah ialah menggunakan aplikasi sembang AI yang menyokong "OpenAI API", kemudian mengisi tiga data: Base URL, API key dari papan pemuka akaun anda, dan nama model.
- 1Pasang aplikasi sembang AI yang mempunyai tetapan "OpenAI API Compatible" / "Custom API" (tersedia untuk Windows, Mac, Android, dan iPhone).
- 2Buka menu Tetapan / Settings dalam aplikasi tersebut, kemudian 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 papan pemuka akaun anda.
- 5Isi Model dengan: Vantenza-V2.6 (atau model lain di bahagian "Pilihan model")
- 6Simpan, kemudian taip soalan pertama anda, contohnya "Hai, apa yang boleh awak bantu?"
Provider : OpenAI API Compatible
Base URL : https://api.vantenza.com
API Key : vt-YOUR-API-KEY
Model : Vantenza-V2.6Lebih kerap bekerja dengan hamparan? Gunakan fungsi =VANTENZA() dalam Google Sheets. Panduan langkah demi langkahnya ada di bahagian "Semua cara menyambung" → Google Sheets.
Lihat panduan Google Sheets3. Pantau kuota & top up
Kuota berkurang setiap kali anda menggunakan AI. Pantau bakinya dan tambah kuota dari papan pemuka akaun anda.
- 1Log masuk ke akaun anda, kemudian buka https://commerce.vantenza.com/ms/account/ai.
- 2Lihat jumlah kuota, kuota yang digunakan, dan baki kuota (dalam rupiah) setiap API key.
- 3Klik "Lihat penggunaan" untuk melihat kos, jumlah permintaan, dan token setiap hari dan setiap model.
- 4Kuota hampir habis? Klik "Top up" pada key itu. Kuota bertambah dan API key kekal sama, jadi aplikasi anda tidak perlu diubah.
- 5Perlukan key berasingan, contohnya untuk aplikasi lain? Beli key baharu. "Tunjukkan key", "Tukar key", dan "Mansuhkan key" meminta kata laluan akaun anda.
Butiran akses
Gunakan nilai berikut dalam aplikasi atau kod apa pun yang menyokong format OpenAI.
curl https://api.vantenza.com/chat/completions \
-H "Authorization: Bearer vt-YOUR-API-KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Vantenza-V2.6",
"messages": [
{"role": "system", "content": "Awak pembantu yang menjawab dengan ringkas dalam bahasa Melayu."},
{"role": "user", "content": "Terangkan apa itu inflasi dalam 2 ayat."}
]
}'Pilihan model
Satu API key boleh menggunakan semua model di bawah. Hanya tukar nama model dalam aplikasi anda. Senarai ini sentiasa memaparkan model yang sedang aktif.
Sembang
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.
Tukar nama model dalam aplikasi anda untuk menggunakan model lain. Model yang lebih pintar menggunakan kuota dengan lebih cepat.
Model selain sembang digunakan melalui endpoint masing-masing, dengan kuota yang sama. Lihat contoh
Semua cara menyambung
Pilih cara yang paling sesuai. Semua cara menggunakan Base URL, model, dan API key yang sama. Jika anda bukan pengaturcara, mulakan dengan "Aplikasi sembang & plugin" atau "Google Sheets".
cURL (terminal)
Hantar satu permintaan terus dari Terminal (macOS/Linux) atau PowerShell/Git Bash (Windows). Sesuai untuk memastikan API key sudah aktif.
Langkah
- 1Salin arahan di bawah.
- 2Gantikan vt-YOUR-API-KEY dengan API key dari papan pemuka akaun anda.
- 3Jalankan di terminal. Jawapan AI ada dalam choices[0].message.content.
curl https://api.vantenza.com/chat/completions \
-H "Authorization: Bearer vt-YOUR-API-KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Vantenza-V2.6",
"messages": [
{"role": "system", "content": "Awak pembantu yang menjawab dengan ringkas dalam bahasa Melayu."},
{"role": "user", "content": "Terangkan apa itu inflasi dalam 2 ayat."}
]
}'Ciri API lain
Selain sembang, API key yang sama boleh digunakan untuk embedding, menjana imej, teks ke suara, suara ke teks, dan semakan baki. Semua penggunaan ditolak daripada kuota rupiah yang sama. Contoh di bawah menggunakan model yang sedang aktif.
Senarai endpoint
Sembang: 3 format
Semua model sembang boleh dipanggil dalam tiga format: OpenAI Chat Completions (contohnya di bahagian "Semua cara menyambung"), OpenAI Responses, dan Anthropic Messages. Pilih yang sesuai dengan library anda; hasil dan kuotanya sama.
Langkah
- 1Chat Completions: https://api.vantenza.com/v1/chat/completions. Format paling biasa, digunakan hampir semua aplikasi.
- 2Responses: https://api.vantenza.com/v1/responses. Jawapan ada di output[].content[].text.
- 3Messages (format Anthropic): https://api.vantenza.com/v1/messages. API key boleh dihantar dalam header x-api-key atau Authorization: Bearer. Jawapan ada di content[0].text.
- 4Gantikan vt-YOUR-API-KEY dengan API key anda, kemudian jalankan di terminal.
curl https://api.vantenza.com/v1/responses \
-H "Authorization: Bearer vt-YOUR-API-KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Vantenza-V2.6",
"input": "Terangkan apa itu inflasi dalam 2 ayat."
}'Panduan ikut pekerjaan
Contoh penggunaan dan prompt sedia guna untuk pelbagai pekerjaan. Klik "Salin" kemudian gantikan bahagian dalam [kurungan siku].
Pengaturcara
Tambahkan keupayaan AI pada aplikasi, percepatkan pengekodan, dan automasikan kerja rutin.
Boleh digunakan untuk
- Membina ciri AI dalam aplikasi: chatbot, ringkasan automatik, klasifikasi tiket, pengekstrakan data.
- Menerangkan, menyemak, dan mengemaskan kod.
- Menulis unit test, dokumentasi, dan mesej commit.
- Menulis query SQL dan regex daripada penerangan dalam bahasa biasa.
- Menukar teks bebas kepada JSON berstruktur.
Cara yang disyorkan
Tip
- Gunakan mesej role "system" untuk menetapkan peranan dan format jawapan secara konsisten.
- Minta format berstruktur ("jawab hanya dengan JSON") supaya hasilnya mudah diproses oleh program.
- Panjang jawapan setiap permintaan dihadkan mengikut model (lihat "Pilihan model"). Untuk hasil yang panjang, pecahkan kepada beberapa permintaan.
- Simpan API key dalam environment variable atau secret manager, bukan dalam repositori.
Contoh prompt
Awak seorang jurutera perisian kanan. Semak kod berikut: cari pepijat, isu keselamatan, dan bahagian yang boleh dipermudahkan. Paparkan dalam senarai bernombor berserta pembaikannya. ``` [tampal kod] ```
Buat unit test lengkap (kes biasa, kes sempadan, dan ralat) untuk fungsi berikut menggunakan [pytest / Jest / PHPUnit]. Sertakan penerangan ringkas bagi setiap test. ``` [tampal fungsi] ```
Ekstrak data daripada teks berikut ke JSON dengan medan: nama, email, telefon, bandar. Isi null jika tiada. Jawab HANYA dengan JSON yang sah. Teks: [tampal teks]
Jadual: orders(id, customer_id, total, created_at), customers(id, name, city). Tulis query PostgreSQL untuk memaparkan 10 bandar dengan jumlah jualan tertinggi bulan lepas, kemudian terangkan secara ringkas cara ia berfungsi.
Buat mesej commit dengan format Conventional Commits (maksimum 72 aksara untuk tajuk) berdasarkan perubahan berikut: [tampal git diff]
Kuota & token
Fahami cara kuota dikira supaya penggunaan lebih jimat.
Kuota dalam rupiah
Kuota API key sama dengan nilai yang anda bayar. Setiap permintaan mengurangkan kuota mengikut jumlah token yang diproses.
Apakah itu token?
Token ialah cebisan perkataan. Secara kasar 1 token ≈ 4 aksara bahasa Inggeris; bahasa Melayu biasanya menggunakan sedikit lebih banyak token bagi setiap perkataan.
Input & output
Input ialah semua teks yang anda hantar (termasuk sejarah perbualan). Output ialah jawapan AI. Token output lebih mahal, jadi minta jawapan yang ringkas jika boleh.
Had setiap permintaan
Setiap model mempunyai had panjang jawapan dan saiz permintaan tersendiri (lihat "Pilihan model"). Gambar, video, dan fail turut dikira sebagai token input.
Tip menjimatkan kuota
- Minta jawapan yang ringkas dan spesifik, contohnya "maksimum 3 poin" atau "jawab satu perkataan".
- Hantar hanya bahagian dokumen yang berkaitan, bukan keseluruhan dokumen.
- Hadkan sejarah perbualan: hantar beberapa mesej terakhir sahaja.
- Simpan (cache) jawapan untuk soalan yang sama supaya tidak dihantar berulang kali.
Tip menulis prompt
Kualiti jawapan sangat bergantung pada cara anda bertanya. Gunakan corak berikut.
Beri peranan
Mulakan dengan peranan AI, contohnya "Awak seorang akauntan berpengalaman".
Terangkan konteks
Nyatakan tujuan, khalayak sasaran, dan maklumat latar yang berkaitan.
Tentukan format
Minta bentuk jawapan: poin, jadual, JSON, atau bilangan perkataan tertentu.
Beri contoh
Satu atau dua contoh hasil yang dikehendaki menjadikan jawapan jauh lebih konsisten.
Pecahkan tugasan besar
Minta rangka dahulu, kemudian kembangkan setiap bahagian.
Ulang dan perbaiki
Perbaiki dengan mesej susulan: "lebih ringkas", "lebih formal", "tambah contoh".
Templat prompt
Peranan : Awak seorang [peranan, contohnya penganalisis kewangan berpengalaman].
Konteks : [latar belakang dan tujuan].
Tugasan : [apa yang perlu dilakukan].
Format : [poin / jadual / JSON / maksimum N perkataan].
Data :
[tampal data atau teks di sini]Buatkan kapsyen.
Awak seorang penulis iklan media sosial. Buat 3 kapsyen Instagram (maks. 30 perkataan, gaya santai) untuk promosi diskaun 20% kopi susu gula melaka, sasaran pelajar universiti. Akhiri dengan ajakan untuk membeli.
Jika berlaku ralat
Jika permintaan gagal, API memulangkan status HTTP dan mesej ralat dalam format berikut:
{
"error": {
"message": "Your quota has been used up. Please purchase more quota.",
"type": "insufficient_quota",
"code": "quota_exhausted"
}
}| Status | Mesej | Punca | Penyelesaian |
|---|---|---|---|
| 401 | API key salah, tidak lengkap, tidak dihantar, atau sudah ditukar atau dimansuhkan. | Salin semula API key dari papan pemuka akaun anda. Pastikan header berformat "Authorization: Bearer <API key>". | |
| 429 | Kuota API key sudah habis. | Semak baki kuota di https://commerce.vantenza.com/ms/account/ai, kemudian top up key yang sama. API key-nya tidak berubah. | |
| 429 | Terlalu banyak permintaan dalam masa yang singkat. | Tunggu beberapa saat kemudian cuba lagi. Untuk program, beri jeda dan cuba semula secara automatik (retry dengan backoff). | |
| 413 | Kandungan permintaan (teks, sejarah perbualan, gambar, video, fail) melebihi had model. | Kecilkan atau mampatkan fail, hantar dokumen sebahagian demi sebahagian, kurangkan sejarah perbualan, atau gunakan model dengan had yang lebih besar. | |
| 400 | Nama model salah, atau model tersebut sedang tidak aktif. | Gunakan nama dari bahagian "Pilihan model", contohnya "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 dalam library). | |
| 500 / 503 | Gangguan sementara pada pelayan. | Cuba lagi sebentar nanti. Jika berterusan, hubungi cs@vantenza.com. |
Keselamatan
API key sama seperti kata laluan: sesiapa yang memilikinya boleh menggunakan kuota anda.
- Jangan kongsikan API key dengan orang lain atau dalam kumpulan sembang.
- Jangan letakkan API key dalam kod yang berjalan di pelayar, aplikasi mudah alih, atau repositori awam.
- Simpan API key dalam environment variable, secret manager, atau Sifat skrip (Google Sheets).
- Jika API key bocor, segera gunakan "Tukar key" di papan pemuka: key lama terus berhenti berfungsi, kuotanya kekal. Perlukan bantuan? Hubungi cs@vantenza.com.
- Jangan hantar data sensitif (kata laluan, nombor kad, data peribadi orang lain) kepada AI.
- Jawapan AI boleh tersilap. Semak semula fakta, angka, dan kod sebelum digunakan.
Glosari istilah
Istilah yang kerap muncul, diterangkan dalam bahasa harian.
- Top up
- Menambah kuota ke API key yang sedia ada. Key-nya kekal sama, jadi aplikasi anda tidak perlu diubah.
- API key
- Kunci peribadi (seperti kata laluan) yang membolehkan AI mengenali anda dan menolak kuota anda. Jangan dikongsi.
- Base URL
- Alamat pelayan Vantenza AI yang dimasukkan ke dalam aplikasi, iaitu https://api.vantenza.com.
- Model
- Nama "otak" AI yang digunakan, contohnya Vantenza-V2.6. Pilihan lengkapnya ada di bahagian "Pilihan model".
- Prompt
- Arahan atau soalan yang anda taip untuk AI.
- Token
- Unit cebisan perkataan yang dikira oleh AI. Semakin panjang teks, semakin banyak token yang digunakan.
- Kuota
- Baki penggunaan anda (dalam rupiah) yang berkurang mengikut jumlah token yang digunakan.
- Endpoint
- Alamat lengkap untuk menghantar soalan melalui program: https://api.vantenza.com/chat/completions.
Soalan Lazim
Soalan yang kerap ditanya.
Apa itu API key, dan untuk apa?
API key ialah kod rahsia yang menjadi pengenalan anda apabila sesebuah aplikasi menggunakan AI. Tampalkan dalam aplikasi sembang, Google Sheets atau kod anda bersama Base URL dan nama model, dan setiap penggunaan dikira daripada kuota anda. Simpan dengan baik dan jangan kongsikan dengan orang lain.
Bagaimana cara mendapatkan API key?
Daftar atau log masuk di commerce.vantenza.com, kemudian beli kuota Vantenza AI. Selepas pembayaran disahkan, API key dipaparkan di papan pemuka akaun anda (https://commerce.vantenza.com/ms/account/ai) berserta kuotanya.
API key saya hilang. Bagaimana untuk melihatnya semula?
Log masuk ke akaun anda, buka https://commerce.vantenza.com/ms/account/ai, kemudian klik "Tunjukkan key" dan masukkan kata laluan akaun anda. Jika key mungkin bocor, gunakan "Tukar key": key lama berhenti berfungsi, kuotanya kekal.
Bagaimana cara menyemak baki kuota?
Buka https://commerce.vantenza.com/ms/account/ai. Baki kuota dipaparkan dalam rupiah, dan "Lihat penggunaan" menunjukkan kos, jumlah permintaan, dan token setiap hari dan setiap model.
Apa itu token AI, dan berapa banyak yang boleh saya gunakan dengan kuota saya?
Kuota dikira berdasarkan jumlah token (cebisan perkataan) yang diproses: teks yang anda hantar (input) dan jawapan AI (output). Jawapan lebih mahal daripada input. Token yang sudah digunakan dipaparkan setiap hari dan setiap model di papan pemuka akaun anda.
Apa yang berlaku apabila kuota habis?
Permintaan seterusnya akan ditolak dengan mesej "Your quota has been used up". Top up key yang sama untuk meneruskan; API key-nya tidak berubah.
Adakah kuota mempunyai tempoh sah?
Kuota tidak berkurang jika tidak digunakan. Hubungi cs@vantenza.com jika ada soalan tentang terma pembelian.
Bolehkah satu API key digunakan dalam beberapa aplikasi?
Boleh. Semua penggunaan akan mengurangkan kuota yang sama. Jangan kongsikan API key dengan orang lain.
Adakah AI mengingati perbualan sebelumnya?
Tidak. Setiap permintaan berdiri sendiri. Untuk perbualan berterusan, hantar semula sejarah mesej sebelumnya dalam array messages (lihat contoh "Perbualan" di bahagian Python). Aplikasi sembang biasanya melakukannya secara automatik.
Kenapa jawapan AI terpotong?
Setiap model mempunyai had panjang jawapan (lihat "Pilihan model"). Jika terpotong (finish_reason = "length"), minta AI menyambung dengan mesej "teruskan", atau pecahkan tugasan kepada beberapa bahagian.
Bolehkah saya menghantar gambar, video, atau fail?
Boleh. Hantar foto, video, atau dokumen PDF bersama soalan anda (contoh ada di tab "Gambar, video & fail"). Jenis input dan saiz maksimum setiap model tertera di bahagian "Pilihan model". Menjana gambar dan suara tersedia melalui endpoint API tersendiri (lihat bahagian "Ciri API lain" dalam panduan); menjana video belum disokong.
Model mana yang sebaiknya saya gunakan?
Mulakan dengan model lalai. Gunakan model "Lite" untuk sembang ringan dan volum besar supaya jimat, dan model yang lebih pintar untuk pengekodan atau analisis yang rumit. Semua model menggunakan kuota yang sama; model yang lebih pintar menghabiskannya dengan lebih cepat.
Adakah data saya selamat?
Elakkan menghantar data sensitif seperti kata laluan, nombor kad, nombor akaun bank penuh, atau data peribadi orang lain. Tanpanamakan data sebelum dihantar.
Perlukan bantuan? Hubungics@vantenza.com