說明文件
Vantenza AI 完整使用指南
使用 Vantenza AI API key 所需的一切:從購買額度、串接應用程式,到適合您工作的提示詞範例。
Vantenza AI 是什麼?
Vantenza AI 是一項 AI(人工智慧)服務,能協助您寫作、摘要、翻譯、分析資料,甚至撰寫程式碼,無論使用印尼語或其他語言都可以。
依需求付費
沒有月費訂閱。您只要購買一次額度,用完為止。
免信用卡
在 commerce.vantenza.com 透過 iPaymu 付款(QRIS、電子錢包、虛擬帳號等)。
文字、圖片、影片與檔案
傳送問題、照片、影片或 PDF 文件,只要一個 API key,就能在聊天應用程式、Google Sheets 或您的程式中使用。
從這裡開始
請依序完成以下三個步驟。每個步驟在下方都有完整說明。
1. 取得 API key
您的第一筆額度訂單付款後,API key 會立即在您的 commerce.vantenza.com 帳戶中建立。
- 1使用電子郵件與密碼在 commerce.vantenza.com 建立帳戶;如果已有帳戶,直接登入即可。
- 2點選「購買額度」,選擇金額與「新建 key」,再於 iPaymu 頁面以 QRIS、電子錢包或虛擬帳號付款。
- 3付款確認後,開啟 https://commerce.vantenza.com/zh-tw/account/ai。您的新 API key 就在那裡,並附有其額度。
- 4點選「顯示 key」,再次輸入帳戶密碼,然後複製 key。Base URL 與模型名稱請見下方「存取資訊」部分。
- 5請將 API key 保存在安全的地方。您可以隨時在控制台中再次顯示它。
2. 最簡單的使用方式
從沒用過 API?沒關係。最簡單的方式是使用支援「OpenAI API」的 AI 聊天應用程式,再填入三項資料:Base URL、帳戶控制台中的 API key 與模型名稱。
- 1安裝具有「OpenAI API Compatible」/「Custom API」設定的 AI 聊天應用程式(Windows、Mac、Android 與 iPhone 皆有)。
- 2開啟該應用程式的「設定」/ Settings 選單,然後選擇供應商(provider)「OpenAI API Compatible」或「Custom」。
- 3在 API Host / Base URL 欄位填入:https://api.vantenza.com
- 4在 API Key 欄位填入帳戶控制台中的 API key。
- 5在 Model 欄位填入:Vantenza-V2.6(或「模型選擇」中的其他模型)
- 6儲存後,輸入您的第一個問題,例如「嗨,你可以幫我做什麼?」
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登入您的帳戶,然後開啟 https://commerce.vantenza.com/zh-tw/account/ai。
- 2查看每個 API key 的總額度、已使用額度與剩餘額度(以印尼盾計算)。
- 3點選「查看使用量」,查看按日、按模型的費用、請求數與 token。
- 4額度快用完了?點選該 key 上的「儲值」。額度會增加,API key 保持不變,因此您的應用程式不需要任何修改。
- 5需要另一個 key,例如給其他應用程式使用?請購買新 key。「顯示 key」「更換 key」與「撤銷 key」都需要輸入帳戶密碼。
存取資訊
在任何支援 OpenAI 格式的應用程式或程式碼中使用以下設定值。
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 即可使用下列所有模型,只要在應用程式中更換模型名稱即可。此清單會隨時顯示目前啟用中的模型。
對話
Paling hemat dan tercepat. Cocok untuk chat, livechat, Google Sheets, dan membaca gambar.
Seimbang antara kualitas dan harga. Cocok untuk pemakaian umum, coding, gambar, video, dan dokumen.
Paling pintar. Cocok untuk coding kompleks, agent, dan analisis berat.
Berpikir bertahap. Cocok untuk matematika, logika, dan coding yang butuh penalaran, lebih hemat dari Pro.
專用模型
Mengubah teks jadi vektor untuk pencarian dan RAG.
Membuat gambar dari teks.
Mengubah teks jadi suara.
Mengubah rekaman suara jadi teks.
在您的應用程式中更換模型名稱即可使用其他模型。越聰明的模型消耗額度越快。
非對話模型透過各自的端點呼叫,使用同一份額度。 查看範例
所有串接方式
選擇最適合您的方式。所有方式都使用相同的 Base URL、模型與 API key。如果您不是工程師,請從「聊天應用程式與外掛」或「Google Sheets」開始。
cURL(終端機)
直接從 Terminal(macOS/Linux)或 PowerShell/Git Bash(Windows)送出一個請求。適合用來確認 API key 是否已啟用。
步驟
- 1複製下方的指令。
- 2將 vt-YOUR-API-KEY 替換成帳戶控制台中的 API key。
- 3在終端機中執行。AI 的回答位於 choices[0].message.content。
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。選擇與您的函式庫相符的格式即可,結果與額度都相同。
步驟
- 1Chat Completions:https://api.vantenza.com/v1/chat/completions。最常見的格式,幾乎所有應用程式都支援。
- 2Responses:https://api.vantenza.com/v1/responses。回答位於 output[].content[].text。
- 3Messages(Anthropic 格式):https://api.vantenza.com/v1/messages。API key 可放在 x-api-key 標頭或 Authorization: Bearer 中。回答位於 content[0].text。
- 4將 vt-YOUR-API-KEY 換成您的 API key,然後在終端機中執行。
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。
建議方式
小技巧
- 使用 role 為「system」的訊息,一致地設定角色與回答格式。
- 要求結構化的格式(「只回覆 JSON」),讓結果方便程式處理。
- 每次請求的回答長度受模型限制(請見「模型選擇」)。需要較長的結果時,請拆成多次請求。
- 將 API key 存放在環境變數或 secret manager 中,不要放在程式碼儲存庫裡。
提示詞範例
你是一位資深軟體工程師。請審查以下程式碼:找出 bug、安全性問題,以及可以簡化的部分。以編號清單列出,並附上修正方式。 ``` [貼上程式碼] ```
請使用 [pytest / Jest / PHPUnit] 為以下函式撰寫完整的單元測試(一般情況、邊界情況與錯誤情況)。每個測試附上簡短說明。 ``` [貼上函式] ```
從以下文字中擷取資料並轉成 JSON,欄位為:name、email、phone、city。沒有的欄位請填 null。只回覆有效的 JSON。 文字:[貼上文字]
資料表:orders(id, customer_id, total, created_at)、customers(id, name, city)。請撰寫一個 PostgreSQL 查詢,列出上個月銷售總額最高的 10 個城市,並簡短說明它的運作方式。
請根據以下變更,以 Conventional Commits 格式撰寫 commit 訊息(標題最多 72 個字元): [貼上 git diff]
額度與 token
了解額度的計算方式,用起來更省。
以印尼盾計算的額度
API key 的額度等於您支付的金額。每次請求都會依處理的 token 數量扣除額度。
Token 是什麼?
Token 是文字的片段。大約 1 個 token ≈ 4 個英文字元;印尼語每個字通常會用到稍多的 token。
輸入與輸出
輸入是您傳送的所有文字(包括對話紀錄)。輸出是 AI 的回答。輸出 token 較貴,因此盡可能要求簡潔的回答。
每次請求的上限
每個模型都有各自的回答長度與請求大小上限(請見「模型選擇」)。圖片、影片與檔案也會計入輸入 token。
節省額度的技巧
- 要求簡短、具體的回答,例如「最多 3 點」或「用一個詞回答」。
- 只傳送文件中相關的部分,而不是整份文件。
- 限制對話紀錄:只傳送最近幾則訊息。
- 將相同問題的回答存起來(快取),避免重複傳送。
撰寫提示詞的技巧
回答的品質很大程度取決於您提問的方式。請參考以下模式。
指定角色
先設定 AI 的角色,例如「你是一位經驗豐富的會計師」。
說明背景
說明目的、受眾與相關的背景資訊。
指定格式
要求回答的形式:條列、表格、JSON 或特定字數。
提供範例
附上一兩個期望結果的範例,能讓回答更加一致。
拆解大型任務
先要求大綱,再逐段展開。
反覆修正
用後續訊息調整:「再簡短一點」、「再正式一點」、「加上範例」。
提示詞範本
角色:你是[角色,例如經驗豐富的財務分析師]。
背景:[背景與目標]。
任務:[需要完成的事項]。
格式:[條列 / 表格 / JSON / 最多 N 字]。
資料:
[在此貼上資料或文字]幫我寫文案。
你是社群媒體文案寫手。請為黑糖拿鐵 8 折優惠寫 3 則 Instagram 貼文文案(每則最多 30 字,語氣輕鬆),目標族群是大學生。結尾加上購買號召。
遇到錯誤時
如果請求失敗,API 會以下列格式回傳 HTTP 狀態碼與錯誤訊息:
{
"error": {
"message": "Your quota has been used up. Please purchase more quota.",
"type": "insufficient_quota",
"code": "quota_exhausted"
}
}| 狀態 | 訊息 | 原因 | 解決方法 |
|---|---|---|---|
| 401 | API key 錯誤、不完整、未傳送,或已被更換或撤銷。 | 從帳戶控制台重新複製 API key。請確認 header 格式為「Authorization: Bearer <API key>」。 | |
| 429 | API key 的額度已用完。 | 在 https://commerce.vantenza.com/zh-tw/account/ai 查看剩餘額度,然後為同一個 key 儲值。API key 不會改變。 | |
| 429 | 短時間內送出過多請求。 | 等待幾秒後再試一次。若是程式,請加入間隔並自動重試(使用 backoff 重試)。 | |
| 413 | 請求內容(文字、對話紀錄、圖片、影片、檔案)超過模型上限。 | 縮小或壓縮檔案、分段傳送文件、減少對話紀錄,或改用上限較高的模型。 | |
| 400 | 模型名稱錯誤,或該模型目前未啟用。 | 請使用「模型選擇」中列出的名稱,例如「Vantenza-V2.6」。模型名稱有區分大小寫。 | |
| 404 | Endpoint 位址錯誤。 | 請使用 https://api.vantenza.com/chat/completions(在函式庫中則使用 Base URL https://api.vantenza.com)。 | |
| 500 / 503 | 伺服器暫時發生問題。 | 請稍後再試。如果問題持續,請聯絡 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