Tài liệu
Hướng dẫn đầy đủ về Vantenza AI
Mọi thứ bạn cần để dùng API key Vantenza AI: từ mua hạn mức, kết nối với ứng dụng, đến prompt mẫu cho công việc của bạn.
Vantenza AI là gì?
Vantenza AI là dịch vụ AI (trí tuệ nhân tạo) có thể giúp bạn viết, tóm tắt, dịch, phân tích dữ liệu, đến viết code, bằng tiếng Indonesia, tiếng Việt hay các ngôn ngữ khác.
Trả theo nhu cầu
Không có thuê bao hằng tháng. Bạn mua hạn mức một lần rồi dùng đến khi hết.
Không cần thẻ tín dụng
Thanh toán qua iPaymu trên commerce.vantenza.com (QRIS, ví điện tử, tài khoản ảo và các hình thức khác).
Văn bản, hình ảnh, video & tệp
Gửi câu hỏi, ảnh, video hoặc tài liệu PDF, rồi dùng trong ứng dụng chat, Google Sheets hoặc chương trình của bạn với một API key.
Bắt đầu từ đây
Làm theo ba bước này theo thứ tự. Mỗi bước đều có hướng dẫn chi tiết bên dưới.
- 1
Nhận API key
Đăng ký hoặc đăng nhập trên commerce.vantenza.com, rồi mua hạn mức. API key được lưu ngay trong tài khoản của bạn.
Mua hạn mức - 2
Dùng AI
Nhập API key vào ứng dụng chat, Google Sheets hoặc chương trình của bạn, rồi bắt đầu đặt câu hỏi.
Xem cách dùng - 3
Theo dõi & nạp thêm
Xem hạn mức còn lại và mức dùng trên bảng điều khiển tài khoản, rồi nạp thêm cho chính key đó khi sắp hết.
Mở bảng điều khiển
1. Nhận API key
API key được tạo trong tài khoản của bạn trên commerce.vantenza.com ngay khi lần mua hạn mức đầu tiên được thanh toán.
- 1Tạo tài khoản trên commerce.vantenza.com bằng email và mật khẩu, hoặc đăng nhập nếu bạn đã có tài khoản.
- 2Nhấn "Mua hạn mức", chọn mệnh giá và "Key mới", rồi thanh toán trên trang iPaymu bằng QRIS, ví điện tử hoặc tài khoản ảo.
- 3Khi thanh toán được xác nhận, mở https://commerce.vantenza.com/vi/account/ai. API key mới của bạn nằm ở đó, kèm hạn mức của nó.
- 4Nhấn "Hiện key", nhập lại mật khẩu tài khoản, rồi sao chép key. Base URL và tên model có trong mục "Thông tin truy cập" bên dưới.
- 5Lưu API key ở nơi an toàn. Bạn có thể hiện lại key bất cứ lúc nào từ bảng điều khiển.
2. Cách dùng dễ nhất
Chưa từng dùng API? Không sao cả. Cách dễ nhất là dùng một ứng dụng chat AI có hỗ trợ "OpenAI API", rồi điền ba thông tin: Base URL, API key từ bảng điều khiển tài khoản và tên model.
- 1Cài một ứng dụng chat AI có phần cài đặt "OpenAI API Compatible" / "Custom API" (có cho Windows, Mac, Android và iPhone).
- 2Mở menu Cài đặt / Settings trong ứng dụng đó, rồi chọn nhà cung cấp (provider) "OpenAI API Compatible" hoặc "Custom".
- 3Điền API Host / Base URL là: https://api.vantenza.com
- 4Điền API Key bằng API key từ bảng điều khiển tài khoản của bạn.
- 5Điền Model là: Vantenza-V2.6 (hoặc model khác trong phần "Lựa chọn model")
- 6Lưu lại, rồi gõ câu hỏi đầu tiên, ví dụ "Xin chào, bạn có thể giúp gì cho tôi?"
Provider : OpenAI API Compatible
Base URL : https://api.vantenza.com
API Key : vt-YOUR-API-KEY
Model : Vantenza-V2.6Bạn làm việc với bảng tính nhiều hơn? Hãy dùng hàm =VANTENZA() trong Google Sheets. Hướng dẫn từng bước có trong phần "Tất cả cách kết nối" → Google Sheets.
Xem hướng dẫn Google Sheets3. Theo dõi hạn mức & nạp thêm
Hạn mức giảm mỗi lần bạn dùng AI. Theo dõi phần còn lại và nạp thêm hạn mức từ bảng điều khiển tài khoản.
- 1Đăng nhập tài khoản, rồi mở https://commerce.vantenza.com/vi/account/ai.
- 2Xem tổng hạn mức, hạn mức đã dùng và hạn mức còn lại (bằng rupiah) của từng API key.
- 3Nhấn "Xem mức sử dụng" để xem chi phí, số request và token theo ngày và theo model.
- 4Sắp hết hạn mức? Nhấn "Nạp thêm" trên key đó. Hạn mức tăng lên và API key giữ nguyên, nên ứng dụng của bạn không cần thay đổi.
- 5Cần một key riêng, chẳng hạn cho ứng dụng khác? Hãy mua key mới. "Hiện key", "Đổi key" và "Thu hồi key" đều yêu cầu mật khẩu tài khoản.
Thông tin truy cập
Dùng các giá trị sau trong bất kỳ ứng dụng hoặc code nào hỗ trợ định dạng 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": "Bạn là trợ lý trả lời ngắn gọn bằng tiếng Việt."},
{"role": "user", "content": "Giải thích lạm phát là gì trong 2 câu."}
]
}'Lựa chọn model
Một API key dùng được tất cả model bên dưới. Chỉ cần đổi tên model trong ứng dụng của bạn. Danh sách này luôn hiển thị các model đang hoạt động.
Chat
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.
Mô hình chuyên dụng
Mengubah teks jadi vektor untuk pencarian dan RAG.
Membuat gambar dari teks.
Mengubah teks jadi suara.
Mengubah rekaman suara jadi teks.
Đổi tên model trong ứng dụng của bạn để dùng model khác. Model thông minh hơn sẽ dùng hết hạn mức nhanh hơn.
Các model không phải chat được dùng qua endpoint riêng, với cùng hạn mức. Xem ví dụ
Tất cả cách kết nối
Chọn cách phù hợp nhất. Mọi cách đều dùng chung Base URL, model và API key. Nếu bạn không phải lập trình viên, hãy bắt đầu với "Ứng dụng chat & plugin" hoặc "Google Sheets".
cURL (terminal)
Gửi một request trực tiếp từ Terminal (macOS/Linux) hoặc PowerShell/Git Bash (Windows). Phù hợp để kiểm tra API key đã hoạt động hay chưa.
Các bước
- 1Sao chép lệnh bên dưới.
- 2Thay vt-YOUR-API-KEY bằng API key từ bảng điều khiển tài khoản của bạn.
- 3Chạy trong terminal. Câu trả lời của AI nằm ở 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": "Bạn là trợ lý trả lời ngắn gọn bằng tiếng Việt."},
{"role": "user", "content": "Giải thích lạm phát là gì trong 2 câu."}
]
}'Các tính năng API khác
Ngoài chat, cùng một API key còn dùng được cho embedding, tạo ảnh, chuyển văn bản thành giọng nói, chuyển giọng nói thành văn bản và kiểm tra số dư. Mọi mức sử dụng đều trừ vào cùng một hạn mức rupiah. Các ví dụ bên dưới dùng những model đang hoạt động.
Danh sách endpoint
Chat: 3 định dạng
Mọi model chat đều gọi được bằng ba định dạng: OpenAI Chat Completions (ví dụ ở phần "Tất cả cách kết nối"), OpenAI Responses và Anthropic Messages. Chọn định dạng hợp với thư viện của bạn; kết quả và hạn mức như nhau.
Các bước
- 1Chat Completions: https://api.vantenza.com/v1/chat/completions. Định dạng phổ biến nhất, hầu hết ứng dụng đều dùng.
- 2Responses: https://api.vantenza.com/v1/responses. Câu trả lời nằm ở output[].content[].text.
- 3Messages (định dạng Anthropic): https://api.vantenza.com/v1/messages. Gửi API key trong header x-api-key hoặc Authorization: Bearer. Câu trả lời nằm ở content[0].text.
- 4Thay vt-YOUR-API-KEY bằng API key của bạn, rồi chạy trong terminal.
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": "Giải thích lạm phát là gì trong 2 câu."
}'Hướng dẫn theo công việc
Ví dụ sử dụng và prompt dùng ngay cho nhiều công việc khác nhau. Nhấn "Sao chép" rồi thay phần trong [ngoặc vuông].
Lập trình viên
Thêm khả năng AI vào ứng dụng, tăng tốc viết code và tự động hóa công việc lặp lại.
Có thể dùng để
- Xây dựng tính năng AI trong ứng dụng: chatbot, tóm tắt tự động, phân loại ticket, trích xuất dữ liệu.
- Giải thích, review và chỉnh gọn code.
- Viết unit test, tài liệu và commit message.
- Viết truy vấn SQL và regex từ mô tả bằng ngôn ngữ thường.
- Chuyển văn bản tự do thành JSON có cấu trúc.
Cách nên dùng
Mẹo
- Dùng tin nhắn role "system" để đặt vai trò và định dạng câu trả lời một cách nhất quán.
- Yêu cầu định dạng có cấu trúc ("chỉ trả lời JSON") để chương trình dễ xử lý kết quả.
- Độ dài câu trả lời mỗi request bị giới hạn theo model (xem "Lựa chọn model"). Với kết quả dài, hãy chia thành nhiều request.
- Lưu API key trong biến môi trường hoặc secret manager, đừng để trong repository.
Prompt mẫu
Bạn là senior software engineer. Hãy review đoạn code sau: tìm bug, vấn đề bảo mật và những phần có thể đơn giản hóa. Trình bày thành danh sách đánh số kèm cách sửa. ``` [dán code] ```
Viết unit test đầy đủ (trường hợp bình thường, biên và lỗi) cho hàm sau bằng [pytest / Jest / PHPUnit]. Kèm giải thích ngắn cho từng test. ``` [dán hàm] ```
Trích xuất dữ liệu từ văn bản sau thành JSON với các trường: họ tên, email, điện thoại, thành phố. Điền null nếu không có. CHỈ trả lời bằng JSON hợp lệ. Văn bản: [dán văn bản]
Bảng: orders(id, customer_id, total, created_at), customers(id, name, city). Viết truy vấn PostgreSQL hiển thị 10 thành phố có tổng doanh thu cao nhất tháng trước, rồi giải thích ngắn gọn cách hoạt động.
Viết commit message theo định dạng Conventional Commits (tiêu đề tối đa 72 ký tự) từ các thay đổi sau: [dán git diff]
Hạn mức & token
Hiểu cách tính hạn mức để dùng tiết kiệm hơn.
Hạn mức bằng rupiah
Hạn mức của API key bằng đúng số tiền bạn đã trả. Mỗi request trừ hạn mức theo số token được xử lý.
Token là gì?
Token là các mảnh của từ. Khoảng 1 token ≈ 4 ký tự tiếng Anh; tiếng Indonesia hay tiếng Việt thường tốn nhiều token hơn một chút cho mỗi từ.
Đầu vào & đầu ra
Đầu vào là toàn bộ văn bản bạn gửi (kể cả lịch sử hội thoại). Đầu ra là câu trả lời của AI. Token đầu ra đắt hơn, nên hãy yêu cầu câu trả lời ngắn gọn khi có thể.
Giới hạn mỗi request
Mỗi model có giới hạn độ dài câu trả lời và kích thước request riêng (xem "Lựa chọn model"). Hình ảnh, video và tệp cũng được tính là token đầu vào.
Mẹo tiết kiệm hạn mức
- Yêu cầu câu trả lời ngắn và cụ thể, ví dụ "tối đa 3 ý" hoặc "trả lời bằng một từ".
- Chỉ gửi phần tài liệu liên quan, không gửi toàn bộ tài liệu.
- Giới hạn lịch sử hội thoại: chỉ gửi vài tin nhắn gần nhất.
- Lưu (cache) câu trả lời cho những câu hỏi giống nhau để không phải gửi lặp lại.
Mẹo viết prompt
Chất lượng câu trả lời phụ thuộc rất nhiều vào cách bạn hỏi. Hãy dùng các nguyên tắc sau.
Giao vai trò
Mở đầu bằng vai trò của AI, ví dụ "Bạn là kế toán giàu kinh nghiệm".
Nêu bối cảnh
Nói rõ mục tiêu, đối tượng và thông tin nền liên quan.
Xác định định dạng
Yêu cầu hình thức câu trả lời: gạch đầu dòng, bảng, JSON hoặc số từ nhất định.
Đưa ví dụ
Một hai ví dụ về kết quả mong muốn giúp câu trả lời nhất quán hơn nhiều.
Chia nhỏ việc lớn
Yêu cầu dàn ý trước, rồi phát triển từng phần.
Lặp lại để cải thiện
Chỉnh sửa bằng tin nhắn tiếp theo: "ngắn hơn", "trang trọng hơn", "thêm ví dụ".
Mẫu prompt
Vai trò : Bạn là [vai trò, ví dụ chuyên viên phân tích tài chính giàu kinh nghiệm].
Bối cảnh : [thông tin nền và mục tiêu].
Nhiệm vụ : [việc cần làm].
Định dạng : [gạch đầu dòng / bảng / JSON / tối đa N từ].
Dữ liệu :
[dán dữ liệu hoặc văn bản vào đây]Viết caption giúp tôi.
Bạn là copywriter mạng xã hội. Viết 3 caption Instagram (tối đa 30 từ, giọng thoải mái) quảng bá giảm giá 20% cà phê sữa đường thốt nốt, đối tượng là sinh viên. Kết thúc bằng lời kêu gọi mua hàng.
Khi gặp lỗi
Khi request thất bại, API trả về mã trạng thái HTTP và thông báo lỗi theo định dạng sau:
{
"error": {
"message": "Your quota has been used up. Please purchase more quota.",
"type": "insufficient_quota",
"code": "quota_exhausted"
}
}| Trạng thái | Thông báo | Nguyên nhân | Cách xử lý |
|---|---|---|---|
| 401 | API key sai, không đầy đủ, không được gửi, hoặc đã bị đổi hay thu hồi. | Sao chép lại API key từ bảng điều khiển tài khoản. Đảm bảo header có định dạng "Authorization: Bearer <API key>". | |
| 429 | Hạn mức của API key đã hết. | Kiểm tra hạn mức còn lại tại https://commerce.vantenza.com/vi/account/ai, rồi nạp thêm cho chính key đó. API key không thay đổi. | |
| 429 | Quá nhiều request trong thời gian ngắn. | Đợi vài giây rồi thử lại. Với chương trình, hãy thêm khoảng nghỉ và tự động thử lại (retry với backoff). | |
| 413 | Nội dung request (văn bản, lịch sử hội thoại, hình ảnh, video, tệp) vượt quá giới hạn của model. | Thu nhỏ hoặc nén tệp, gửi tài liệu theo từng phần, bớt lịch sử hội thoại, hoặc dùng model có giới hạn lớn hơn. | |
| 400 | Tên model sai, hoặc model đó hiện không hoạt động. | Dùng tên trong phần "Lựa chọn model", ví dụ "Vantenza-V2.6". Tên model phân biệt chữ hoa/chữ thường. | |
| 404 | Địa chỉ endpoint sai. | Dùng https://api.vantenza.com/chat/completions (hoặc Base URL https://api.vantenza.com khi dùng thư viện). | |
| 500 / 503 | Máy chủ gặp sự cố tạm thời. | Thử lại sau ít phút. Nếu vẫn tiếp diễn, hãy liên hệ cs@vantenza.com. |
Bảo mật
API key giống như mật khẩu: bất kỳ ai có nó đều có thể dùng hạn mức của bạn.
- Đừng chia sẻ API key cho người khác hoặc trong nhóm chat.
- Đừng đặt API key trong code chạy trên trình duyệt, ứng dụng di động hoặc repository công khai.
- Lưu API key trong biến môi trường (environment variable), secret manager hoặc Thuộc tính tập lệnh (Google Sheets).
- Nếu API key bị lộ, hãy dùng ngay "Đổi key" trên bảng điều khiển: key cũ ngừng hoạt động lập tức, hạn mức vẫn giữ nguyên. Cần hỗ trợ? Liên hệ cs@vantenza.com.
- Đừng gửi dữ liệu nhạy cảm (mật khẩu, số thẻ, dữ liệu cá nhân của người khác) cho AI.
- Câu trả lời của AI có thể sai. Hãy kiểm tra lại thông tin, số liệu và code trước khi sử dụng.
Từ điển thuật ngữ
Các thuật ngữ thường gặp, giải thích bằng ngôn ngữ đời thường.
- Nạp thêm (top up)
- Cộng thêm hạn mức vào API key bạn đang có. Key giữ nguyên, nên ứng dụng của bạn không cần thay đổi.
- API key
- Khóa riêng (giống mật khẩu) giúp AI nhận ra bạn và trừ vào hạn mức của bạn. Không được chia sẻ.
- Base URL
- Địa chỉ máy chủ Vantenza AI được nhập vào ứng dụng, tức là https://api.vantenza.com.
- Model
- Tên "bộ não" AI được sử dụng, ví dụ Vantenza-V2.6. Danh sách đầy đủ có trong phần "Lựa chọn model".
- Prompt
- Lệnh hoặc câu hỏi bạn gõ cho AI.
- Token
- Đơn vị mảnh từ mà AI dùng để tính. Văn bản càng dài thì càng dùng nhiều token.
- Hạn mức
- Số dư sử dụng của bạn (bằng rupiah), giảm dần theo số token đã dùng.
- Endpoint
- Địa chỉ đầy đủ để gửi câu hỏi qua chương trình: https://api.vantenza.com/chat/completions.
FAQ
Những câu hỏi thường gặp.
API key là gì và dùng để làm gì?
API key là mã bí mật để nhận diện bạn khi một ứng dụng sử dụng AI. Dán nó vào ứng dụng chat, Google Sheets hoặc code của bạn cùng với Base URL và tên model, mỗi lần sử dụng sẽ được trừ vào hạn mức của bạn. Hãy giữ kỹ và không chia sẻ cho người khác.
Làm sao để nhận API key?
Đăng ký hoặc đăng nhập trên commerce.vantenza.com, rồi mua hạn mức Vantenza AI. Khi thanh toán được xác nhận, API key hiện trên bảng điều khiển tài khoản (https://commerce.vantenza.com/vi/account/ai) kèm hạn mức của nó.
Tôi làm mất API key. Làm sao để xem lại?
Đăng nhập tài khoản, mở https://commerce.vantenza.com/vi/account/ai, rồi nhấn "Hiện key" và nhập mật khẩu tài khoản. Nếu key có thể đã bị lộ, hãy dùng "Đổi key": key cũ ngừng hoạt động, hạn mức vẫn giữ nguyên.
Làm sao để kiểm tra hạn mức còn lại?
Mở https://commerce.vantenza.com/vi/account/ai. Hạn mức còn lại được hiển thị bằng rupiah, và "Xem mức sử dụng" cho biết chi phí, số request và token theo ngày và theo model.
Token AI là gì và tôi có thể dùng được bao nhiêu với hạn mức của mình?
Hạn mức được tính theo số token (mảnh từ) được xử lý: văn bản bạn gửi (đầu vào) và câu trả lời của AI (đầu ra). Câu trả lời đắt hơn đầu vào. Số token đã dùng được hiển thị theo ngày và theo model trên bảng điều khiển tài khoản.
Điều gì xảy ra khi hết hạn mức?
Các request tiếp theo sẽ bị từ chối với thông báo "Your quota has been used up". Hãy nạp thêm cho chính key đó để tiếp tục; API key không thay đổi.
Hạn mức có thời hạn sử dụng không?
Hạn mức không bị trừ nếu bạn không dùng. Liên hệ cs@vantenza.com nếu bạn có câu hỏi về điều khoản mua hàng.
Một API key có dùng được trên nhiều ứng dụng không?
Được. Mọi lượt dùng sẽ trừ vào cùng một hạn mức. Đừng chia sẻ API key cho người khác.
AI có nhớ cuộc trò chuyện trước đó không?
Không. Mỗi request là độc lập. Để trò chuyện liên tục, hãy gửi lại lịch sử tin nhắn trước đó trong mảng messages (xem ví dụ "Hội thoại" trong phần Python). Ứng dụng chat thường tự động làm việc này.
Vì sao câu trả lời của AI bị cắt ngang?
Mỗi model có giới hạn độ dài câu trả lời (xem "Lựa chọn model"). Nếu bị cắt (finish_reason = "length"), hãy nhờ AI viết tiếp bằng tin nhắn "tiếp tục", hoặc chia nhiệm vụ thành nhiều phần.
Có thể gửi hình ảnh, video hoặc tệp không?
Được. Gửi ảnh, video hoặc tài liệu PDF kèm câu hỏi của bạn (ví dụ có trong tab "Hình ảnh, video & tệp"). Loại đầu vào và kích thước tối đa của từng model được ghi trong phần "Lựa chọn model". Việc tạo hình ảnh và giọng nói có sẵn qua các endpoint API riêng (xem phần "Các tính năng API khác" trong hướng dẫn); việc tạo video hiện chưa được hỗ trợ.
Tôi nên dùng model nào?
Hãy bắt đầu với model mặc định. Dùng model "Lite" cho chat nhẹ và khối lượng lớn để tiết kiệm, và model thông minh hơn cho lập trình hoặc phân tích phức tạp. Tất cả model dùng chung một hạn mức; model thông minh hơn sẽ dùng hết nhanh hơn.
Dữ liệu của tôi có an toàn không?
Tránh gửi dữ liệu nhạy cảm như mật khẩu, số thẻ, số tài khoản ngân hàng đầy đủ hoặc dữ liệu cá nhân của người khác. Hãy ẩn danh dữ liệu trước khi gửi.
Cần trợ giúp? Liên hệcs@vantenza.com