說明文件

Vantenza AI 完整使用指南

使用 Vantenza AI API key 所需的一切:從購買額度、串接應用程式,到適合您工作的提示詞範例。

Vantenza AI 是什麼?

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

依需求付費

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

免信用卡

在 commerce.vantenza.com 透過 iPaymu 付款(QRIS、電子錢包、虛擬帳號等)。

文字、圖片、影片與檔案

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

從這裡開始

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

  1. 1

    取得 API key

    在 commerce.vantenza.com 註冊或登入,然後購買額度。API key 會直接保存在您的帳戶中。

    購買額度
  2. 2

    使用 AI

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

    查看使用方式
  3. 3

    查看與儲值

    在帳戶控制台查看剩餘額度與使用量,額度快用完時為同一個 key 儲值。

    開啟控制台

1. 取得 API key

您的第一筆額度訂單付款後,API key 會立即在您的 commerce.vantenza.com 帳戶中建立。

  1. 1使用電子郵件與密碼在 commerce.vantenza.com 建立帳戶;如果已有帳戶,直接登入即可。
  2. 2點選「購買額度」,選擇金額與「新建 key」,再於 iPaymu 頁面以 QRIS、電子錢包或虛擬帳號付款。
  3. 3付款確認後,開啟 https://commerce.vantenza.com/zh-tw/account/ai。您的新 API key 就在那裡,並附有其額度。
  4. 4點選「顯示 key」,再次輸入帳戶密碼,然後複製 key。Base URL 與模型名稱請見下方「存取資訊」部分。
  5. 5請將 API key 保存在安全的地方。您可以隨時在控制台中再次顯示它。

2. 最簡單的使用方式

從沒用過 API?沒關係。最簡單的方式是使用支援「OpenAI API」的 AI 聊天應用程式,再填入三項資料:Base URL、帳戶控制台中的 API key 與模型名稱。

  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://commerce.vantenza.com/zh-tw/account/ai。
  2. 2查看每個 API key 的總額度、已使用額度與剩餘額度(以印尼盾計算)。
  3. 3點選「查看使用量」,查看按日、按模型的費用、請求數與 token。
  4. 4額度快用完了?點選該 key 上的「儲值」。額度會增加,API key 保持不變,因此您的應用程式不需要任何修改。
  5. 5需要另一個 key,例如給其他應用程式使用?請購買新 key。「顯示 key」「更換 key」與「撤銷 key」都需要輸入帳戶密碼。

存取資訊

在任何支援 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://commerce.vantenza.com/zh-tw/account/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": "你是一位用繁體中文簡短回答的助理。"},
      {"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-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://commerce.vantenza.com/zh-tw/account/ai 查看剩餘額度,然後為同一個 key 儲值。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.伺服器暫時發生問題。請稍後再試。如果問題持續,請聯絡 cs@vantenza.com。

安全性

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

  • 請勿將 API key 分享給他人或貼在群組聊天中。
  • 請勿將 API key 放在瀏覽器端執行的程式碼、行動應用程式或公開的程式碼儲存庫中。
  • 將 API key 存放在環境變數、secret manager 或「指令碼屬性」(Google Sheets)中。
  • 如果 API key 外洩,請立即在控制台中使用「更換 key」:舊 key 會立即停止運作,額度保持不變。需要協助?請聯絡 cs@vantenza.com。
  • 請勿將敏感資料(密碼、卡號、他人的個人資料)傳送給 AI。
  • AI 的回答可能有誤。使用前請再次確認事實、數字與程式碼。

名詞解釋

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

儲值
為既有的 API key 增加額度。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?有什麼用途?

API key 是一組密鑰,用來在應用程式呼叫 AI 時識別您的身分。把它與 Base URL、模型名稱一起填入聊天應用程式、Google Sheets 或您的程式碼中,每次使用都會從您的額度扣除。請妥善保管,不要分享給他人。

如何取得 API key?

在 commerce.vantenza.com 註冊或登入,然後購買 Vantenza AI 額度。付款確認後,API key 會顯示在您的帳戶控制台(https://commerce.vantenza.com/zh-tw/account/ai)中,並附有其額度。

我的 API key 不見了,要怎麼再次查看?

登入您的帳戶,開啟 https://commerce.vantenza.com/zh-tw/account/ai,點選「顯示 key」並輸入帳戶密碼。如果 key 可能已外洩,請使用「更換 key」:舊 key 會停止運作,額度保持不變。

如何查詢剩餘額度?

開啟 https://commerce.vantenza.com/zh-tw/account/ai。剩餘額度以印尼盾顯示,「查看使用量」會列出按日、按模型的費用、請求數與 token。

什麼是 AI token?我的額度可以用多少?

額度依處理的 token(文字片段)數量計算:包括您傳送的文字(輸入)與 AI 的回答(輸出)。回答比輸入更貴。已使用的 token 會在帳戶控制台中按日、按模型顯示。

額度用完時會怎樣?

之後的請求會被拒絕,並顯示訊息「Your quota has been used up」。為同一個 key 儲值即可繼續使用;API key 不會改變。

額度有使用期限嗎?

額度不使用就不會減少。如對購買條款有任何疑問,請聯絡 cs@vantenza.com。

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

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

AI 會記得之前的對話嗎?

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

為什麼 AI 的回答被截斷?

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

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

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

我應該使用哪個模型?

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

我的資料安全嗎?

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

需要協助嗎?請聯絡cs@vantenza.com