Panduan Vantenza AI · Cara guna API key, pemula hingga pengaturcara

Q: Adakah kuota mempunyai tempoh sah?

Kuota tidak berkurang jika tidak digunakan. Hubungi cs@vantenza.com jika ada soalan tentang terma pembelian.

Bayar ikut keperluan

Tiada langganan bulanan. Anda membeli kuota sekali, kemudian menggunakannya sampai habis.

Tanpa kad kredit

Pembayaran melalui kedai Vantenza di Lynk.id (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.

1
Tebus kod
Selepas membeli, anda menerima kod tebus melalui e-mel. Tebus kod itu untuk mendapatkan API key.
Buka halaman tebus
2
Guna AI
Masukkan API key ke dalam aplikasi sembang, Google Sheets, atau program anda, kemudian mula bertanya.
Lihat cara guna
3
Semak baki kuota
Pantau baki kuota dan jumlah penggunaan bila-bila masa dengan memasukkan API key anda.
Semak penggunaan

1Buka e-mel daripada Vantenza Store bertajuk "Kode Redeem Pesanan …" (Kod Tebus Pesanan …). E-mel ini dalam bahasa Indonesia. Jika tiada dalam Peti Masuk, semak folder Spam atau Promosi.
2Klik butang "Redeem sekarang" (Tebus sekarang) dalam e-mel itu. Halaman tebus akan dibuka dengan kod yang sudah diisi.
3Atau buka https://ai.vantenza.com/ms/redeem secara manual, kemudian taip kod tebus (formatnya AIRS-XXXX-XXXX-XXXX).
4Di halaman tebus, klik butang "Tebus sekarang". Butiran akses anda terus dipaparkan: API Key, Base URL, dan Model.
5Klik "Salin semua" kemudian simpan di tempat yang selamat (contohnya aplikasi nota peribadi). Anda juga boleh membuka halaman tebus semula bila-bila masa dengan kod yang sama.

Buka halaman tebus

Satu kod tebus hanya sah untuk produk yang anda beli. Jangan kongsikan kod mahupun API key dengan orang lain.

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 halaman tebus.
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?"

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

1Buka https://ai.vantenza.com/ms/usage.
2Tampal API key anda di ruangan yang disediakan, kemudian klik "Semak penggunaan".
3Lihat baki kuota (dalam rupiah), jumlah token yang digunakan, dan anggaran baki token.
4Klik "Kemas kini" untuk melihat angka terkini. Data dikemas kini lebih kurang setiap minit.

Buka semak penggunaan

Jika kuota habis, AI akan membalas "Your quota has been used up". Beli kuota lagi untuk mendapatkan kod tebus baharu.

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 halaman tebus. Hantar dalam header Authorization: Bearer <API key>.

Semak penggunaanhttps://ai.vantenza.com/ms/usage

Baki kuota dalam rupiah dan token yang digunakan.

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."}
    ]
  }'

Sembang

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

teksgambarvideofile

Jawapan maks. 32,768 tokenSaiz permintaan maks. 20 MB

Lalai

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

teksgambarvideofile

Jawapan maks. 32,768 tokenSaiz permintaan maks. 20 MB

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

teksgambarfile

Jawapan maks. 32,768 tokenSaiz permintaan maks. 20 MB

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

Embedding (carian teks)

Mengubah teks jadi vektor untuk pencarian dan RAG.

teks

Saiz permintaan maks. 4 MB

Jana imej

Membuat gambar dari teks.

teks

Saiz permintaan maks. 4 MB

Teks ke suara

Mengubah teks jadi suara.

teks

Saiz permintaan maks. 1 MB

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

Langkah

1Salin arahan di bawah.
2Gantikan vt-YOUR-API-KEY dengan API key dari halaman tebus.
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."}
    ]
  }'

Senarai endpoint

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.

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

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

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

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]

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.

json

{
  "error": {
    "message": "Your quota has been used up. Please purchase more quota.",
    "type": "insufficient_quota",
    "code": "quota_exhausted"
  }
}

Status	Mesej	Punca	Penyelesaian
401	Invalid API key.	API key salah, tidak lengkap, atau tidak dihantar.	Salin semula API key dari halaman tebus. Pastikan header berformat "Authorization: Bearer <API key>".
429	Your quota has been used up. Please purchase more quota.	Kuota API key sudah habis.	Semak baki kuota di https://ai.vantenza.com/ms/usage. Beli kuota lagi untuk mendapatkan API key baharu.
429	The 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).
413	Request 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.
400	Invalid 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.
404	Not found.	Alamat endpoint salah.	Gunakan https://api.vantenza.com/chat/completions (atau Base URL https://api.vantenza.com dalam library).
500 / 503	The service is temporarily unavailable. Please retry in a moment.	Gangguan sementara pada pelayan.	Cuba lagi sebentar nanti. Jika berterusan, hubungi [email protected].

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

Kod tebus: Kod penebusan daripada e-mel selepas anda membeli. Ditebus sekali untuk mendapatkan API key.
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.

Bagaimana cara mendapatkan API key?

Selepas pembayaran berjaya, kod tebus dihantar ke e-mel anda. Buka https://ai.vantenza.com/ms/redeem, masukkan kod tersebut, dan API key berserta butiran aksesnya terus dipaparkan.

API key saya hilang. Bagaimana untuk melihatnya semula?

Buka semula https://ai.vantenza.com/ms/redeem dan masukkan kod tebus yang sama daripada e-mel. API key yang sama akan dipaparkan semula.

Bagaimana cara menyemak baki kuota?

Buka https://ai.vantenza.com/ms/usage, masukkan API key, kemudian lihat baki kuota (dalam rupiah) dan jumlah token yang digunakan. Data dikemas kini lebih kurang setiap minit.

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. Anggaran jumlah token untuk kuota anda dipaparkan di halaman Semak Penggunaan.

Apa yang berlaku apabila kuota habis?

Permintaan seterusnya akan ditolak dengan mesej "Your quota has been used up". Beli kuota lagi untuk mendapatkan kod tebus dan API key baharu.

Adakah kuota mempunyai tempoh sah?

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

Panduan lengkap Vantenza AI

Apakah itu Vantenza AI?

Bayar ikut keperluan

Tanpa kad kredit

Teks, gambar, video & fail

Mula di sini

Tebus kod

Guna AI

Semak baki kuota

1. Tebus kod

2. Cara guna paling mudah

3. Semak baki kuota

Butiran akses

Pilihan model

Sembang

Model khusus

Semua cara menyambung

cURL (terminal)

Langkah

Ciri API lain

Senarai endpoint

Sembang: 3 format

Langkah

Panduan ikut pekerjaan

Pengaturcara

Boleh digunakan untuk

Cara yang disyorkan

Tip

Contoh prompt

Kuota & token

Kuota dalam rupiah

Apakah itu token?

Input & output

Had setiap permintaan

Tip menjimatkan kuota

Tip menulis prompt

Beri peranan

Terangkan konteks

Tentukan format

Beri contoh

Pecahkan tugasan besar

Ulang dan perbaiki

Templat prompt

Jika berlaku ralat

Keselamatan

Glosari istilah

Soalan Lazim