FIL
Bumili ng quota
Dokumentasyon

Kumpletong gabay sa Vantenza AI

Lahat ng kailangan mo para magamit ang Vantenza AI API key: mula sa pag-redeem, pagkonekta sa mga app, hanggang sa mga halimbawang prompt para sa trabaho mo.

Ano ang Vantenza AI?

Ang Vantenza AI ay isang AI (artificial intelligence) service na makakatulong sa pagsulat, pagbubuod, pagsasalin, pagsusuri ng data, hanggang sa paggawa ng code, sa Bahasa Indonesia man o sa ibang wika.

Magbayad ayon sa kailangan

Walang buwanang subscription. Bibili ka ng quota nang isang beses, tapos gagamitin mo hanggang maubos.

Walang credit card

Magbayad sa tindahan ng Vantenza sa Lynk.id (QRIS, e-wallet, virtual account, at iba pa).

Text, larawan, video at file

Magpadala ng tanong, litrato, video, o PDF na dokumento, at gamitin ito sa chat app, Google Sheets, o sa program mo gamit ang iisang API key.

Magsimula dito

Sundin ang tatlong hakbang na ito nang sunud-sunod. May kumpletong gabay sa ibaba para sa bawat hakbang.

  1. 1

    I-redeem ang code

    Pagkatapos bumili, makakatanggap ka ng redeem code sa email. I-redeem ang code na iyon para makuha ang API key.

    Buksan ang redeem
  2. 2

    Gamitin ang AI

    Ilagay ang API key sa chat app, Google Sheets, o sa program mo, tapos magsimulang magtanong.

    Tingnan kung paano gamitin
  3. 3

    Tingnan ang natitirang quota

    Bantayan ang natitirang quota at dami ng paggamit kahit kailan sa pamamagitan ng paglalagay ng API key mo.

    Tingnan ang paggamit

1. I-redeem ang code

Ang redeem code ay code na ipinapadala sa email mo pagkatapos ng matagumpay na bayad. I-redeem ang code na ito para makuha ang API key.

  1. 1Buksan ang email mula sa Vantenza Store na may subject na "Kode Redeem Pesanan …" (Redeem Code ng Order …). Kung wala sa Inbox, tingnan ang Spam o Promotions folder.
  2. 2I-click ang button na "Redeem sekarang" (I-redeem ngayon) sa loob ng email. Magbubukas ang redeem page na nakalagay na ang code.
  3. 3O buksan nang manual ang https://ai.vantenza.com/fil/redeem, tapos i-type ang redeem code (ang format ay AIRS-XXXX-XXXX-XXXX).
  4. 4Sa redeem page, i-click ang button na "I-redeem ngayon". Agad lalabas ang mga detalye ng access mo: API Key, Base URL, at Model.
  5. 5I-click ang "Kopyahin lahat" at itago sa ligtas na lugar (halimbawa, sa personal mong notes app). Puwede mo ring buksan ulit ang redeem page kahit kailan gamit ang parehong code.
Buksan ang redeem page

2. Pinakamadaling paraan ng paggamit

Hindi pa nakagamit ng API? Walang problema. Ang pinakamadaling paraan ay gumamit ng AI chat app na sumusuporta sa "OpenAI API", tapos ilagay ang tatlong datos mula sa redeem page.

  1. 1Mag-install ng AI chat app na may setting na "OpenAI API Compatible" / "Custom API" (available para sa Windows, Mac, Android, at iPhone).
  2. 2Buksan ang menu na Settings sa app na iyon, tapos piliin ang provider na "OpenAI API Compatible" o "Custom".
  3. 3Ilagay sa API Host / Base URL ang: https://api.vantenza.com
  4. 4Ilagay sa API Key ang API key mula sa redeem page.
  5. 5Ilagay sa Model ang: Vantenza-V2.6 (o ibang model sa bahaging "Mga pagpipiliang model")
  6. 6I-save, tapos i-type ang una mong tanong, halimbawa "Hello, ano ang maitutulong mo?"
text
Provider : OpenAI API Compatible
Base URL : https://api.vantenza.com
API Key  : vt-YOUR-API-KEY
Model    : Vantenza-V2.6

Mas madalas ka bang magtrabaho sa spreadsheet? Gamitin ang function na =VANTENZA() sa Google Sheets. Nasa bahaging "Lahat ng paraan ng pagkonekta" → Google Sheets ang step-by-step na gabay.

Tingnan ang gabay sa Google Sheets

3. Tingnan ang natitirang quota

Nababawasan ang quota tuwing gumagamit ka ng AI. Tingnan ang natitira kahit kailan, libre.

  1. 1Buksan ang https://ai.vantenza.com/fil/usage.
  2. 2I-paste ang API key mo sa field, tapos i-click ang "Tingnan ang paggamit".
  3. 3Tingnan ang natitirang quota (sa rupiah), dami ng nagamit na token, at tinatayang natitirang token.
  4. 4I-click ang "I-refresh" para makita ang pinakabagong numero. Ina-update ang data humigit-kumulang bawat minuto.
Buksan ang pagtingin ng paggamit

Mga detalye ng access

Gamitin ang mga value na ito sa kahit anong app o code na sumusuporta sa OpenAI format.

Base URLhttps://api.vantenza.com
May mga app na humihingi ng /v1 sa dulo; parehong suportado.
Chat endpointhttps://api.vantenza.com/chat/completions
POST method, OpenAI Chat Completions format.
ModelVantenza-V2.6
Default na model. Nasa bahaging "Mga pagpipiliang model" ang iba pang model.
API keyvt-YOUR-API-KEY
Mula sa redeem page. Ipadala sa header na Authorization: Bearer <API key>.
Tingnan ang paggamithttps://ai.vantenza.com/fil/usage
Natitirang quota sa rupiah at nagamit na token.
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": "Ikaw ay isang assistant na sumasagot nang maikli sa Filipino."},
      {"role": "user", "content": "Ipaliwanag kung ano ang inflation sa 2 pangungusap."}
    ]
  }'

Mga pagpipiliang model

Magagamit ng isang API key ang lahat ng model sa ibaba. Palitan lang ang pangalan ng model sa app mo. Laging ipinapakita ng listahang ito ang mga model na kasalukuyang aktibo.

Chat

Vantenza-V2.6-Lite

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

teksgambarvideofile
Max na sagot 32,768 tokenMax na laki ng request 20 MB
Vantenza-V2.6
Default

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

teksgambarvideofile
Max na sagot 32,768 tokenMax na laki ng request 20 MB
Vantenza-V2.6-Pro

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

teksgambarfile
Max na sagot 32,768 tokenMax na laki ng request 20 MB
Vantenza-V2.6-Reasoning

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

teks
Max na sagot 32,768 tokenMax na laki ng request 4 MB

Mga espesyal na model

Vantenza-Embed
Embedding (paghahanap ng teksto)

Mengubah teks jadi vektor untuk pencarian dan RAG.

teks
Max na laki ng request 4 MB
Vantenza-Image
Paggawa ng larawan

Membuat gambar dari teks.

teks
Max na laki ng request 4 MB
Vantenza-Voice
Text to speech

Mengubah teks jadi suara.

teks
Max na laki ng request 1 MB
Vantenza-Transcribe
Speech to text

Mengubah rekaman suara jadi teks.

audio
Max na laki ng request 20 MB

Palitan ang pangalan ng model sa app mo para gumamit ng ibang model. Mas mabilis umubos ng quota ang mas matatalinong model.

Ang mga model na hindi pang-chat ay ginagamit sa sarili nilang endpoint, gamit ang parehong quota. Tingnan ang mga halimbawa

Lahat ng paraan ng pagkonekta

Piliin ang pinakaangkop na paraan. Iisang Base URL, model, at API key ang ginagamit ng lahat ng paraan. Kung hindi ka programmer, magsimula sa "Mga chat app at plugin" o "Google Sheets".

Pinakamabilis na paraan para subukan ang API key mula sa terminal.

cURL (terminal)

Magpadala ng isang request direkta mula sa Terminal (macOS/Linux) o PowerShell/Git Bash (Windows). Bagay para matiyak na aktibo na ang API key.

Mga hakbang

  1. 1Kopyahin ang command sa ibaba.
  2. 2Palitan ang vt-YOUR-API-KEY ng API key mula sa redeem page.
  3. 3Patakbuhin sa terminal. Nasa choices[0].message.content ang sagot ng AI.
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": "Ikaw ay isang assistant na sumasagot nang maikli sa Filipino."},
      {"role": "user", "content": "Ipaliwanag kung ano ang inflation sa 2 pangungusap."}
    ]
  }'

Iba pang feature ng API

Bukod sa chat, magagamit din ang parehong API key para sa embedding, paggawa ng larawan, text to speech, speech to text, at pag-check ng balanse. Lahat ng paggamit ay ibinabawas sa parehong quota na rupiah. Gumagamit ang mga halimbawa sa ibaba ng mga model na aktibo ngayon.

Listahan ng endpoint

Para sa mga programmer na gumagamit ng library o tool na may ibang format.

Chat: 3 format

Matatawag ang bawat chat model sa tatlong format: OpenAI Chat Completions (may halimbawa sa "Lahat ng paraan ng pagkonekta"), OpenAI Responses, at Anthropic Messages. Piliin ang tugma sa library mo; pareho ang resulta at quota.

Mga hakbang

  1. 1Chat Completions: https://api.vantenza.com/v1/chat/completions. Ang pinakakaraniwang format, ginagamit ng halos lahat ng app.
  2. 2Responses: https://api.vantenza.com/v1/responses. Nasa output[].content[].text ang sagot.
  3. 3Messages (format ng Anthropic): https://api.vantenza.com/v1/messages. Ipadala ang API key sa header na x-api-key o bilang Authorization: Bearer. Nasa content[0].text ang sagot.
  4. 4Palitan ang vt-YOUR-API-KEY ng API key mo, saka patakbuhin sa 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": "Ipaliwanag ang inflation sa 2 pangungusap."
  }'

Gabay ayon sa trabaho

Mga halimbawa ng paggamit at handang prompt para sa iba't ibang trabaho. I-click ang "Kopyahin" at palitan ang mga bahaging nasa [square bracket].

Programmer

Magdagdag ng kakayahan ng AI sa mga app, pabilisin ang coding, at i-automate ang mga paulit-ulit na gawain.

Magagamit para sa

  • Gumawa ng mga AI feature sa app: chatbot, awtomatikong buod, pag-classify ng ticket, pagkuha ng data.
  • Magpaliwanag, mag-review, at mag-ayos ng code.
  • Gumawa ng unit test, dokumentasyon, at commit message.
  • Sumulat ng SQL query at regex mula sa paglalarawan sa karaniwang salita.
  • Gawing structured na JSON ang malayang text.

Inirerekomendang paraan

PythonJavaScript / Node.jsPHP / LaravelcURL (terminal)Mga chat app at plugin

Mga tip

  • Gamitin ang mensaheng may role na "system" para itakda nang pare-pareho ang papel at format ng sagot.
  • Humingi ng structured na format ("sumagot lang ng JSON") para madaling maproseso ng program ang resulta.
  • May limitasyon ang haba ng sagot bawat request ayon sa model (tingnan ang "Mga pagpipiliang model"). Para sa mahahabang resulta, hatiin sa ilang request.
  • I-save ang API key sa environment variable o secret manager, hindi sa repository.

Mga halimbawang prompt

Code review

Ikaw ay isang senior software engineer. I-review ang sumusunod na code: hanapin ang mga bug, problema sa seguridad, at mga bahaging puwedeng gawing mas simple. Ipakita sa numbered list kasama ang mga ayos. ``` [i-paste ang code] ```

Unit test

Gumawa ng kumpletong unit test (normal, edge, at error na kaso) para sa sumusunod na function gamit ang [pytest / Jest / PHPUnit]. Magsama ng maikling paliwanag sa bawat test. ``` [i-paste ang function] ```

Text papuntang JSON

Kunin ang data mula sa sumusunod na text at ilagay sa JSON na may mga field: pangalan, email, telepono, lungsod. Lagyan ng null kung wala. Sumagot LAMANG ng valid na JSON. Text: [i-paste ang text]

SQL query

Mga table: orders(id, customer_id, total, created_at), customers(id, name, city). Sumulat ng PostgreSQL query na nagpapakita ng 10 lungsod na may pinakamalaking kabuuang benta noong nakaraang buwan, tapos ipaliwanag nang maikli kung paano ito gumagana.

Commit message

Gumawa ng commit message sa format na Conventional Commits (hanggang 72 character ang title) mula sa sumusunod na mga pagbabago: [i-paste ang git diff]

Quota at token

Unawain kung paano binibilang ang quota para mas makatipid sa paggamit.

Quota sa rupiah

Ang quota ng API key ay kapareho ng halagang binayaran mo. Bawat request ay bumabawas sa quota ayon sa dami ng token na naproseso.

Ano ang token?

Ang token ay piraso ng salita. Humigit-kumulang 1 token ≈ 4 na character sa English; sa Bahasa Indonesia, karaniwang medyo mas maraming token bawat salita.

Input at output

Ang input ay lahat ng text na ipinapadala mo (kasama ang history ng usapan). Ang output ay ang sagot ng AI. Mas mahal ang output token, kaya humingi ng maikling sagot kung puwede.

Limitasyon bawat request

May sariling limitasyon ang bawat model sa haba ng sagot at laki ng request (tingnan ang "Mga pagpipiliang model"). Kasama ring binibilang bilang input token ang mga larawan, video, at file.

Mga tip para makatipid sa quota

  • Humingi ng maikli at tiyak na sagot, halimbawa "hanggang 3 punto lang" o "sagutin sa isang salita".
  • Ipadala lang ang bahagi ng dokumento na may kinalaman, hindi ang buong dokumento.
  • Limitahan ang history ng usapan: ipadala lang ang ilang huling mensahe.
  • I-save (cache) ang sagot sa parehong tanong para hindi na paulit-ulit na ipinapadala.

Mga tip sa pagsulat ng prompt

Malaki ang epekto ng paraan ng pagtatanong mo sa kalidad ng sagot. Gamitin ang pattern na ito.

Magbigay ng papel

Magsimula sa papel ng AI, halimbawa "Ikaw ay isang bihasang accountant".

Ipaliwanag ang konteksto

Banggitin ang layunin, audience, at mahalagang background na impormasyon.

Tukuyin ang format

Hingin ang anyo ng sagot: bullet points, table, JSON, o tiyak na dami ng salita.

Magbigay ng halimbawa

Isa o dalawang halimbawa ng gustong resulta ay nagpapaging mas pare-pareho ang sagot.

Hatiin ang malaking gawain

Humingi muna ng outline, tapos palawakin bawat bahagi.

Ulit-ulitin

Pagandahin gamit ang follow-up na mensahe: "mas maikli", "mas pormal", "magdagdag ng halimbawa".

Template ng prompt

text
Papel     : Ikaw ay [papel, halimbawa isang bihasang financial analyst].
Konteksto : [background at layunin].
Gawain    : [ano ang dapat gawin].
Format    : [bullet points / table / JSON / hanggang N salita].
Data      :
[i-paste ang data o text dito]
✗ Hindi malinaw

Gawan mo ako ng caption.

✓ Malinaw

Ikaw ay isang social media copywriter. Gumawa ng 3 Instagram caption (hanggang 30 salita, casual na estilo) para sa 20% discount promo ng kapeng may gatas at brown sugar, para sa mga college student. Tapusin sa paanyayang bumili.

Kapag may error

Kapag pumalya ang request, magbabalik ang API ng HTTP status at error message sa ganitong format:

json
{
  "error": {
    "message": "Your quota has been used up. Please purchase more quota.",
    "type": "insufficient_quota",
    "code": "quota_exhausted"
  }
}
StatusMensaheSanhiSolusyon
401Invalid API key.Mali, kulang, o hindi naipadala ang API key.Kopyahin ulit ang API key mula sa redeem page. Siguraduhing ang header ay nasa format na "Authorization: Bearer <API key>".
429Your quota has been used up. Please purchase more quota.Ubos na ang quota ng API key.Tingnan ang natitirang quota sa https://ai.vantenza.com/fil/usage. Bumili ulit ng quota para makakuha ng bagong API key.
429The service is busy. Please retry in a moment.Masyadong maraming request sa maikling panahon.Maghintay ng ilang segundo at subukan ulit. Para sa program, maglagay ng pagitan at awtomatikong pag-ulit (retry na may backoff).
413Request is too large for this model (max …).Lumampas sa limitasyon ng model ang laman ng request (text, history ng usapan, larawan, video, file).Paliitin o i-compress ang file, ipadala ang dokumento nang pa-bahagi, bawasan ang history ng usapan, o gumamit ng model na may mas malaking limitasyon.
400Invalid model name passed in model=…Mali ang pangalan ng model, o hindi aktibo ang model na iyon sa ngayon.Gamitin ang pangalan mula sa bahaging "Mga pagpipiliang model", halimbawa "Vantenza-V2.6". Case-sensitive ang pangalan ng model (mahalaga ang malaki at maliit na titik).
404Not found.Mali ang address ng endpoint.Gamitin ang https://api.vantenza.com/chat/completions (o ang Base URL na https://api.vantenza.com sa library).
500 / 503The service is temporarily unavailable. Please retry in a moment.Pansamantalang aberya sa server.Subukan ulit mamaya. Kung magpatuloy, makipag-ugnayan sa [email protected].

Seguridad

Ang API key ay parang password: sinumang may hawak nito ay makakagamit ng quota mo.

  • Huwag ibahagi ang API key sa ibang tao o sa group chat.
  • Huwag ilagay ang API key sa code na tumatakbo sa browser, mobile app, o pampublikong repository.
  • I-save ang API key sa environment variable, secret manager, o Script Properties (Google Sheets).
  • Kung na-leak ang API key, agad makipag-ugnayan sa [email protected].
  • Huwag magpadala ng sensitibong data (password, numero ng card, personal na data ng ibang tao) sa AI.
  • Puwedeng magkamali ang sagot ng AI. Suriin ulit ang mga fact, numero, at code bago gamitin.

Diksyunaryo ng mga termino

Mga terminong madalas lumabas, ipinaliwanag sa simpleng salita.

Redeem code
Code na natanggap mo sa email pagkatapos bumili. Nire-redeem nang isang beses para makuha ang API key.
API key
Personal na susi (parang password) na nagpapakilala sa iyo sa AI at bumabawas sa quota mo. Huwag itong ibahagi.
Base URL
Address ng server ng Vantenza AI na inilalagay sa app, ito ay https://api.vantenza.com.
Model
Pangalan ng "utak" ng AI na ginagamit, halimbawa Vantenza-V2.6. Nasa bahaging "Mga pagpipiliang model" ang kumpletong listahan.
Prompt
Utos o tanong na tina-type mo para sa AI.
Token
Yunit ng piraso ng salita na binibilang ng AI. Kapag mas mahaba ang text, mas maraming token ang nagagamit.
Quota
Balanse ng paggamit mo (sa rupiah) na nababawasan ayon sa dami ng token na nagamit.
Endpoint
Buong address para magpadala ng tanong sa pamamagitan ng program: https://api.vantenza.com/chat/completions.

FAQ

Mga madalas itanong.

Paano makakuha ng API key?

Pagkatapos ng matagumpay na bayad, ipinapadala ang redeem code sa email mo. Buksan ang https://ai.vantenza.com/fil/redeem, ilagay ang code, at agad lalabas ang API key kasama ang mga detalye ng access.

Nawala ang API key ko. Paano ko ito makikita ulit?

Buksan ulit ang https://ai.vantenza.com/fil/redeem at ilagay ang parehong redeem code mula sa email. Ipapakita ulit ang parehong API key.

Paano tingnan ang natitirang quota?

Buksan ang https://ai.vantenza.com/fil/usage, ilagay ang API key, tapos tingnan ang natitirang quota (sa rupiah) at dami ng token na nagamit. Ina-update ang data humigit-kumulang bawat minuto.

Gaano karami ang magagamit ko sa quota ko?

Binibilang ang quota mula sa dami ng token (piraso ng salita) na naproseso: ang text na ipinapadala mo (input) at ang sagot ng AI (output). Mas mahal ang sagot kaysa sa input. Makikita ang tinatayang dami ng token para sa quota mo sa page na "Tingnan ang paggamit".

Ano ang mangyayari kapag naubos ang quota?

Tatanggihan ang susunod na request na may mensaheng "Your quota has been used up". Bumili ulit ng quota para makakuha ng bagong redeem code at API key.

May expiration ba ang quota?

Hindi nababawasan ang quota kung hindi ginagamit. Makipag-ugnayan sa [email protected] kung may tanong tungkol sa mga tuntunin ng pagbili.

Puwede bang gamitin ang isang API key sa ilang app?

Oo. Lahat ng paggamit ay bumabawas sa iisang quota. Huwag ibahagi ang API key sa ibang tao.

Naaalala ba ng AI ang mga naunang usapan?

Hindi. Hiwalay ang bawat request. Para sa tuloy-tuloy na usapan, ipadala ulit ang history ng mga naunang mensahe sa messages array (tingnan ang halimbawang "Usapan" sa bahaging Python). Karaniwang awtomatiko itong ginagawa ng mga chat app.

Bakit naputol ang sagot ng AI?

May limitasyon ang bawat model sa haba ng sagot (tingnan ang "Mga pagpipiliang model"). Kung naputol (finish_reason = "length"), ipatuloy sa AI gamit ang mensaheng "ituloy mo", o hatiin ang gawain sa ilang bahagi.

Puwede bang magpadala ng larawan, video, o file?

Oo. Magpadala ng litrato, video, o PDF na dokumento kasama ang tanong mo (may halimbawa sa tab na "Larawan, video at file"). Nakalista sa bahaging "Mga pagpipiliang model" ang uri ng input at max na laki para sa bawat model. Puwedeng gumawa ng larawan at audio sa pamamagitan ng hiwalay na API endpoint (tingnan ang bahaging "Iba pang feature ng API" sa gabay); hindi pa suportado ang paggawa ng video.

Aling model ang dapat kong gamitin?

Magsimula sa default na model. Gamitin ang "Lite" na model para sa magaan na chat at malaking volume para makatipid, at ang mas matalinong model para sa coding o komplikadong pagsusuri. Iisang quota ang ginagamit ng lahat ng model; mas mabilis itong inuubos ng mas matatalinong model.

Ligtas ba ang data ko?

Iwasang magpadala ng sensitibong data gaya ng password, numero ng card, buong numero ng bank account, o personal na data ng ibang tao. Gawing anonymous ang data bago ito ipadala.