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

    Guna AI

    Masukkan API key ke dalam aplikasi sembang, Google Sheets, atau program anda, kemudian mula bertanya.

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

  1. 1Daftar akaun di commerce.vantenza.com dengan e-mel dan kata laluan, atau log masuk jika sudah ada akaun.
  2. 2Klik "Beli kuota", pilih nilai dan "Key baharu", kemudian bayar di halaman iPaymu dengan QRIS, e-dompet, atau akaun maya.
  3. 3Selepas pembayaran disahkan, buka https://commerce.vantenza.com/ms/account/ai. API key baharu anda ada di situ, lengkap dengan kuotanya.
  4. 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.
  5. 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.

  1. 1Pasang aplikasi sembang AI yang mempunyai tetapan "OpenAI API Compatible" / "Custom API" (tersedia untuk Windows, Mac, Android, dan iPhone).
  2. 2Buka menu Tetapan / Settings dalam aplikasi tersebut, kemudian 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 papan pemuka akaun anda.
  5. 5Isi Model dengan: Vantenza-V2.6 (atau model lain di bahagian "Pilihan model")
  6. 6Simpan, kemudian taip soalan pertama anda, contohnya "Hai, apa yang boleh awak bantu?"
text
Provider : OpenAI API Compatible
Base URL : https://api.vantenza.com
API Key  : vt-YOUR-API-KEY
Model    : Vantenza-V2.6

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

3. Pantau kuota & top up

Kuota berkurang setiap kali anda menggunakan AI. Pantau bakinya dan tambah kuota dari papan pemuka akaun anda.

  1. 1Log masuk ke akaun anda, kemudian buka https://commerce.vantenza.com/ms/account/ai.
  2. 2Lihat jumlah kuota, kuota yang digunakan, dan baki kuota (dalam rupiah) setiap API key.
  3. 3Klik "Lihat penggunaan" untuk melihat kos, jumlah permintaan, dan token setiap hari dan setiap model.
  4. 4Kuota hampir habis? Klik "Top up" pada key itu. Kuota bertambah dan API key kekal sama, jadi aplikasi anda tidak perlu diubah.
  5. 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.

Base URLhttps://api.vantenza.com
Sesetengah aplikasi meminta akhiran /v1; kedua-duanya disokong.
Endpoint sembanghttps://api.vantenza.com/chat/completions
Kaedah POST, format OpenAI Chat Completions.
ModelVantenza-V2.6
Model lalai. Model lain ada di bahagian "Pilihan model".
API keyvt-YOUR-API-KEY
Dari papan pemuka akaun anda. Hantar dalam header Authorization: Bearer <API key>.
Papan pemukahttps://commerce.vantenza.com/ms/account/ai
Baki kuota, penggunaan setiap hari dan model, serta top up.
bash
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

Vantenza-V2.6-Lite

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

teksgambarvideofile
Jawapan maks. 32,768 tokenSaiz permintaan maks. 20 MB
Vantenza-V2.6-Pro

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

teksgambarfile
Jawapan maks. 32,768 tokenSaiz permintaan maks. 20 MB
Vantenza-V2.6-Reasoning

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

teks
Jawapan maks. 32,768 tokenSaiz permintaan maks. 4 MB

Model khusus

Vantenza-Embed
Embedding (carian teks)

Mengubah teks jadi vektor untuk pencarian dan RAG.

teks
Saiz permintaan maks. 4 MB
Vantenza-Image
Jana imej

Membuat gambar dari teks.

teks
Saiz permintaan maks. 4 MB
Vantenza-Voice
Teks ke suara

Mengubah teks jadi suara.

teks
Saiz permintaan maks. 1 MB
Vantenza-Transcribe
Suara ke teks

Mengubah rekaman suara jadi teks.

audio
Saiz permintaan maks. 20 MB

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

Cara terpantas menguji API key dari terminal.

cURL (terminal)

Hantar satu permintaan terus dari Terminal (macOS/Linux) atau PowerShell/Git Bash (Windows). Sesuai untuk memastikan API key sudah aktif.

Langkah

  1. 1Salin arahan di bawah.
  2. 2Gantikan vt-YOUR-API-KEY dengan API key dari papan pemuka akaun anda.
  3. 3Jalankan di terminal. Jawapan AI ada dalam choices[0].message.content.
bash
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

Untuk pengaturcara yang menggunakan library atau alat dengan format berbeza.

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

  1. 1Chat Completions: https://api.vantenza.com/v1/chat/completions. Format paling biasa, digunakan hampir semua aplikasi.
  2. 2Responses: https://api.vantenza.com/v1/responses. Jawapan ada di output[].content[].text.
  3. 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.
  4. 4Gantikan vt-YOUR-API-KEY dengan API key anda, kemudian jalankan di terminal.
bash
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

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

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

Semakan kod

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] ```

Unit test

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] ```

Teks ke JSON

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]

Query SQL

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.

Mesej commit

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

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

Buatkan kapsyen.

✓ Jelas

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:

json
{
  "error": {
    "message": "Your quota has been used up. Please purchase more quota.",
    "type": "insufficient_quota",
    "code": "quota_exhausted"
  }
}
StatusMesejPuncaPenyelesaian
401Invalid API key.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>".
429Your quota has been used up. Please purchase more quota.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.
429The service is busy. Please retry in a moment.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).
413Request is too large for this model (max …).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.
400Invalid model name passed in model=…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.
404Not found.Alamat endpoint salah.Gunakan https://api.vantenza.com/chat/completions (atau Base URL https://api.vantenza.com dalam library).
500 / 503The service is temporarily unavailable. Please retry in a moment.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