繁
購買額度
說明文件

Vantenza AI 完整使用指南

使用 Vantenza AI API key 所需的一切：從兌換、串接應用程式，到適合您工作的提示詞範例。

Vantenza AI 是什麼？

Vantenza AI 是一項 AI（人工智慧）服務，能協助您寫作、摘要、翻譯、分析資料，甚至撰寫程式碼，無論使用印尼語或其他語言都可以。

依需求付費

沒有月費訂閱。您只要購買一次額度，用完為止。

免信用卡

透過 Lynk.id 上的 Vantenza 商店付款（QRIS、電子錢包、虛擬帳號等）。

文字、圖片、影片與檔案

傳送問題、照片、影片或 PDF 文件，只要一個 API key，就能在聊天應用程式、Google Sheets 或您的程式中使用。

從這裡開始

請依序完成以下三個步驟。每個步驟在下方都有完整說明。

  1. 1

    使用兌換碼

    購買後，您會透過電子郵件收到兌換碼。兌換該代碼即可取得 API key。

    前往兌換
  2. 2

    使用 AI

    將 API key 填入聊天應用程式、Google Sheets 或您的程式中，就能開始提問。

    查看使用方式
  3. 3

    查詢剩餘額度

    輸入您的 API key，隨時追蹤剩餘額度與用量。

    查詢用量

1. 使用兌換碼

兌換碼是付款成功後寄到您電子郵件的代碼。兌換此代碼即可取得 API key。

  1. 1開啟 Vantenza Store 寄來、主旨為「Kode Redeem Pesanan …」（訂單兌換碼）的電子郵件。如果收件匣裡沒有，請查看垃圾郵件或促銷內容資料夾。
  2. 2點擊電子郵件中的「Redeem sekarang」（立即兌換）按鈕。兌換頁面會開啟，並已自動填入兌換碼。
  3. 3或手動開啟 https://ai.vantenza.com/zh-tw/redeem，再輸入兌換碼（格式為 AIRS-XXXX-XXXX-XXXX）。
  4. 4在網站上點擊「立即兌換」。您的存取資訊會立即顯示：API Key、Base URL 與模型。
  5. 5點擊「全部複製」，然後保存在安全的地方（例如私人筆記 App）。之後也可以隨時用同一組兌換碼再次開啟兌換頁面。
開啟兌換頁面

2. 最簡單的使用方式

從沒用過 API？沒關係。最簡單的方式是使用支援「OpenAI API」的 AI 聊天應用程式，再填入兌換頁面上的三項資料。

  1. 1安裝具有「OpenAI API Compatible」/「Custom API」設定的 AI 聊天應用程式（Windows、Mac、Android 與 iPhone 皆有）。
  2. 2開啟該應用程式的「設定」/ Settings 選單，然後選擇供應商（provider）「OpenAI API Compatible」或「Custom」。
  3. 3在 API Host / Base URL 欄位填入：https://api.vantenza.com
  4. 4在 API Key 欄位填入兌換頁面上的 API key。
  5. 5在 Model 欄位填入：Vantenza-V2.6（或「模型選擇」中的其他模型）
  6. 6儲存後，輸入您的第一個問題，例如「嗨，你可以幫我做什麼？」
text
Provider : OpenAI API Compatible
Base URL : https://api.vantenza.com
API Key  : vt-YOUR-API-KEY
Model    : Vantenza-V2.6

常在試算表中工作嗎？在 Google Sheets 中使用 =VANTENZA() 函式。逐步教學請見「所有串接方式」→ Google Sheets。

查看 Google Sheets 指南

3. 查詢剩餘額度

每次使用 AI 都會扣除額度。您可以隨時免費查詢剩餘額度。

  1. 1開啟 https://ai.vantenza.com/zh-tw/usage。
  2. 2將您的 API key 貼到欄位中，然後點擊「查詢用量」。
  3. 3查看剩餘額度（以印尼盾計算）、已使用的 token 數與預估剩餘 token。
  4. 4點擊「重新整理」查看最新數字。資料約每分鐘更新一次。
開啟用量查詢

存取資訊

在任何支援 OpenAI 格式的應用程式或程式碼中使用以下設定值。

Base URLhttps://api.vantenza.com
部分應用程式要求加上 /v1 結尾；兩種寫法都支援。
對話 endpointhttps://api.vantenza.com/chat/completions
POST 方法，OpenAI Chat Completions 格式。
模型Vantenza-V2.6
預設模型。其他模型請見「模型選擇」。
API keyvt-YOUR-API-KEY
來自兌換頁面。放在 Authorization: Bearer <API key> header 中傳送。
查詢用量https://ai.vantenza.com/zh-tw/usage
以印尼盾計算的剩餘額度與已使用的 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": "你是一位用繁體中文簡短回答的助理。"},
      {"role": "user", "content": "用 2 句話解釋什麼是通貨膨脹。"}
    ]
  }'

模型選擇

一個 API key 即可使用下列所有模型，只要在應用程式中更換模型名稱即可。此清單會隨時顯示目前啟用中的模型。

對話

Vantenza-V2.6-Lite

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

teksgambarvideofile
回答上限 32,768 token請求大小上限 20 MB
Vantenza-V2.6
預設

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

teksgambarvideofile
回答上限 32,768 token請求大小上限 20 MB
Vantenza-V2.6-Pro

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

teksgambarfile
回答上限 32,768 token請求大小上限 20 MB
Vantenza-V2.6-Reasoning

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

teks
回答上限 32,768 token請求大小上限 4 MB

專用模型

Vantenza-Embed
Embedding（文字搜尋）

Mengubah teks jadi vektor untuk pencarian dan RAG.

teks
請求大小上限 4 MB
Vantenza-Image
生成圖片

Membuat gambar dari teks.

teks
請求大小上限 4 MB
Vantenza-Voice
文字轉語音

Mengubah teks jadi suara.

teks
請求大小上限 1 MB
Vantenza-Transcribe
語音轉文字

Mengubah rekaman suara jadi teks.

audio
請求大小上限 20 MB

在您的應用程式中更換模型名稱即可使用其他模型。越聰明的模型消耗額度越快。

非對話模型透過各自的端點呼叫，使用同一份額度。 查看範例

所有串接方式

選擇最適合您的方式。所有方式都使用相同的 Base URL、模型與 API key。如果您不是工程師，請從「聊天應用程式與外掛」或「Google Sheets」開始。

從終端機測試 API key 最快的方式。

cURL（終端機）

直接從 Terminal（macOS/Linux）或 PowerShell/Git Bash（Windows）送出一個請求。適合用來確認 API key 是否已啟用。

步驟

  1. 1複製下方的指令。
  2. 2將 vt-YOUR-API-KEY 替換成兌換頁面上的 API key。
  3. 3在終端機中執行。AI 的回答位於 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": "你是一位用繁體中文簡短回答的助理。"},
      {"role": "user", "content": "用 2 句話解釋什麼是通貨膨脹。"}
    ]
  }'

更多 API 功能

除了對話，同一組 API key 還能用於 embedding、生成圖片、文字轉語音、語音轉文字與查詢餘額。所有用量都從同一份印尼盾額度扣除。以下範例使用目前可用的模型。

端點列表

適合使用其他格式的函式庫或工具的開發者。

對話：3 種格式

所有對話模型都支援三種呼叫格式：OpenAI Chat Completions（範例見「所有串接方式」）、OpenAI Responses 與 Anthropic Messages。選擇與您的函式庫相符的格式即可，結果與額度都相同。

步驟

  1. 1Chat Completions：https://api.vantenza.com/v1/chat/completions。最常見的格式，幾乎所有應用程式都支援。
  2. 2Responses：https://api.vantenza.com/v1/responses。回答位於 output[].content[].text。
  3. 3Messages（Anthropic 格式）：https://api.vantenza.com/v1/messages。API key 可放在 x-api-key 標頭或 Authorization: Bearer 中。回答位於 content[0].text。
  4. 4將 vt-YOUR-API-KEY 換成您的 API key，然後在終端機中執行。
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": "用 2 句話解釋什麼是通貨膨脹。"
  }'

各職業使用指南

各種工作的使用範例與現成提示詞。點擊「複製」，再替換 [方括號] 中的內容。

工程師

為應用程式加入 AI 能力、加快寫程式的速度，並將例行工作自動化。

適用情境

  • 在應用程式中打造 AI 功能：聊天機器人、自動摘要、工單分類、資料擷取。
  • 解釋、審查並整理程式碼。
  • 撰寫單元測試、文件與 commit 訊息。
  • 根據一般文字描述撰寫 SQL 查詢與正規表示式（regex）。
  • 將自由格式的文字轉換成結構化 JSON。

建議方式

PythonJavaScript / Node.jsPHP / LaravelcURL（終端機）聊天應用程式與外掛

小技巧

  • 使用 role 為「system」的訊息，一致地設定角色與回答格式。
  • 要求結構化的格式（「只回覆 JSON」），讓結果方便程式處理。
  • 每次請求的回答長度受模型限制（請見「模型選擇」）。需要較長的結果時，請拆成多次請求。
  • 將 API key 存放在環境變數或 secret manager 中，不要放在程式碼儲存庫裡。

提示詞範例

程式碼審查

你是一位資深軟體工程師。請審查以下程式碼：找出 bug、安全性問題，以及可以簡化的部分。以編號清單列出，並附上修正方式。 ``` [貼上程式碼] ```

單元測試

請使用 [pytest / Jest / PHPUnit] 為以下函式撰寫完整的單元測試（一般情況、邊界情況與錯誤情況）。每個測試附上簡短說明。 ``` [貼上函式] ```

文字轉 JSON

從以下文字中擷取資料並轉成 JSON，欄位為：name、email、phone、city。沒有的欄位請填 null。只回覆有效的 JSON。 文字：[貼上文字]

SQL 查詢

資料表：orders(id, customer_id, total, created_at)、customers(id, name, city)。請撰寫一個 PostgreSQL 查詢，列出上個月銷售總額最高的 10 個城市，並簡短說明它的運作方式。

Commit 訊息

請根據以下變更，以 Conventional Commits 格式撰寫 commit 訊息（標題最多 72 個字元）： [貼上 git diff]

額度與 token

了解額度的計算方式，用起來更省。

以印尼盾計算的額度

API key 的額度等於您支付的金額。每次請求都會依處理的 token 數量扣除額度。

Token 是什麼？

Token 是文字的片段。大約 1 個 token ≈ 4 個英文字元；印尼語每個字通常會用到稍多的 token。

輸入與輸出

輸入是您傳送的所有文字（包括對話紀錄）。輸出是 AI 的回答。輸出 token 較貴，因此盡可能要求簡潔的回答。

每次請求的上限

每個模型都有各自的回答長度與請求大小上限（請見「模型選擇」）。圖片、影片與檔案也會計入輸入 token。

節省額度的技巧

  • 要求簡短、具體的回答，例如「最多 3 點」或「用一個詞回答」。
  • 只傳送文件中相關的部分，而不是整份文件。
  • 限制對話紀錄：只傳送最近幾則訊息。
  • 將相同問題的回答存起來（快取），避免重複傳送。

撰寫提示詞的技巧

回答的品質很大程度取決於您提問的方式。請參考以下模式。

指定角色

先設定 AI 的角色，例如「你是一位經驗豐富的會計師」。

說明背景

說明目的、受眾與相關的背景資訊。

指定格式

要求回答的形式：條列、表格、JSON 或特定字數。

提供範例

附上一兩個期望結果的範例，能讓回答更加一致。

拆解大型任務

先要求大綱，再逐段展開。

反覆修正

用後續訊息調整：「再簡短一點」、「再正式一點」、「加上範例」。

提示詞範本

text
角色：你是[角色，例如經驗豐富的財務分析師]。
背景：[背景與目標]。
任務：[需要完成的事項]。
格式：[條列 / 表格 / JSON / 最多 N 字]。
資料：
[在此貼上資料或文字]
✗ 不夠清楚

幫我寫文案。

✓ 清楚

你是社群媒體文案寫手。請為黑糖拿鐵 8 折優惠寫 3 則 Instagram 貼文文案（每則最多 30 字，語氣輕鬆），目標族群是大學生。結尾加上購買號召。

遇到錯誤時

如果請求失敗，API 會以下列格式回傳 HTTP 狀態碼與錯誤訊息：

json
{
  "error": {
    "message": "Your quota has been used up. Please purchase more quota.",
    "type": "insufficient_quota",
    "code": "quota_exhausted"
  }
}
狀態訊息原因解決方法
401Invalid API key.API key 錯誤、不完整或未傳送。從兌換頁面重新複製 API key。請確認 header 格式為「Authorization: Bearer <API key>」。
429Your quota has been used up. Please purchase more quota.API key 的額度已用完。在 https://ai.vantenza.com/zh-tw/usage 查詢剩餘額度。再次購買額度即可取得新的 API key。
429The service is busy. Please retry in a moment.短時間內送出過多請求。等待幾秒後再試一次。若是程式，請加入間隔並自動重試（使用 backoff 重試）。
413Request is too large for this model (max …).請求內容（文字、對話紀錄、圖片、影片、檔案）超過模型上限。縮小或壓縮檔案、分段傳送文件、減少對話紀錄，或改用上限較高的模型。
400Invalid model name passed in model=…模型名稱錯誤，或該模型目前未啟用。請使用「模型選擇」中列出的名稱，例如「Vantenza-V2.6」。模型名稱有區分大小寫。
404Not found.Endpoint 位址錯誤。請使用 https://api.vantenza.com/chat/completions（在函式庫中則使用 Base URL https://api.vantenza.com）。
500 / 503The service is temporarily unavailable. Please retry in a moment.伺服器暫時發生問題。請稍後再試。如果問題持續，請聯絡 [email protected]。

安全性

API key 就像密碼：任何人拿到它都能使用您的額度。

  • 請勿將 API key 分享給他人或貼在群組聊天中。
  • 請勿將 API key 放在瀏覽器端執行的程式碼、行動應用程式或公開的程式碼儲存庫中。
  • 將 API key 存放在環境變數、secret manager 或「指令碼屬性」（Google Sheets）中。
  • 如果 API key 外洩，請立即聯絡 [email protected]。
  • 請勿將敏感資料（密碼、卡號、他人的個人資料）傳送給 AI。
  • AI 的回答可能有誤。使用前請再次確認事實、數字與程式碼。

名詞解釋

常見名詞，用日常用語來解釋。

兌換碼
購買後從電子郵件收到的兌換代碼。兌換一次即可取得 API key。
API key
個人專屬的金鑰（就像密碼），讓 AI 辨識您的身分並扣除您的額度。請勿分享。
Base URL
填入應用程式中的 Vantenza AI 伺服器位址，也就是 https://api.vantenza.com。
模型
所使用的 AI「大腦」名稱，例如 Vantenza-V2.6。完整選項請見「模型選擇」。
提示詞（Prompt）
您輸入給 AI 的指令或問題。
Token
AI 計算文字片段的單位。文字越長，使用的 token 越多。
額度
您的使用餘額（以印尼盾計算），會依使用的 token 數量減少。
Endpoint
透過程式傳送問題的完整位址：https://api.vantenza.com/chat/completions。

常見問題

常見的問題。

如何取得 API key？

付款成功後，兌換碼會寄到您的電子郵件。開啟 https://ai.vantenza.com/zh-tw/redeem 並輸入該兌換碼，API key 與存取資訊就會立即顯示。

我的 API key 不見了，要怎麼再次查看？

重新開啟 https://ai.vantenza.com/zh-tw/redeem，並輸入電子郵件中的同一組兌換碼，就會再次顯示同一把 API key。

如何查詢剩餘額度？

開啟 https://ai.vantenza.com/zh-tw/usage，輸入 API key，即可查看剩餘額度（以印尼盾計算）與已使用的 token 數。資料約每分鐘更新一次。

我的額度可以用多少？

額度依處理的 token（文字片段）數量計算：包括您傳送的文字（輸入）與 AI 的回答（輸出）。回答比輸入更貴。您的額度大約可用多少 token，會顯示在「查詢用量」頁面上。

額度用完時會怎樣？

之後的請求會被拒絕，並顯示訊息「Your quota has been used up」。請再次購買額度以取得新的兌換碼與 API key。

額度有使用期限嗎？

額度不使用就不會減少。如對購買條款有任何疑問，請聯絡 [email protected]。

一個 API key 可以在多個應用程式中使用嗎？

可以。所有用量都會從同一份額度中扣除。請勿將 API key 分享給他人。

AI 會記得之前的對話嗎？

不會。每次請求都是獨立的。若要延續對話，請在 messages 陣列中重新傳送先前的訊息紀錄（請見 Python 區塊中的「對話」範例）。聊天應用程式通常會自動處理。

為什麼 AI 的回答被截斷？

每個模型都有回答長度上限（請見「模型選擇」）。如果回答被截斷（finish_reason = "length"），請傳送「繼續」讓 AI 接著寫，或將任務拆成幾個部分。

可以傳送圖片、影片或檔案嗎？

可以。將照片、影片或 PDF 文件連同問題一起傳送（範例請見「圖片、影片與檔案」分頁）。各模型支援的輸入類型與大小上限列在「模型選擇」中。生成圖片與語音可透過獨立的 API 端點實現（請見指南中的「更多 API 功能」區塊）；目前尚不支援生成影片。

我應該使用哪個模型？

先從預設模型開始。輕度聊天和大量處理時使用「Lite」模型比較省；寫程式或複雜分析則使用更聰明的模型。所有模型共用同一份額度；越聰明的模型消耗得越快。

我的資料安全嗎？

請避免傳送密碼、卡號、完整銀行帳號或他人個人資料等敏感資料。傳送前請先將資料匿名化。