Hướng dẫn Vantenza AI · API key từ người mới đến lập trình viên

Q: 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.

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 cửa hàng Vantenza trên Lynk.id (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.

1
Đổi mã
Sau khi mua, bạn nhận được mã redeem qua email. Đổi mã đó để nhận API key.
Mở trang đổi mã
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
Kiểm tra hạn mức còn lại
Theo dõi hạn mức còn lại và mức đã dùng bất cứ lúc nào bằng cách nhập API key của bạn.
Kiểm tra mức dùng

1Mở email từ Vantenza Store có tiêu đề "Kode Redeem Pesanan …" (nghĩa là "Mã redeem đơn hàng …"; email được gửi bằng tiếng Indonesia). Nếu không thấy trong Hộp thư đến, hãy kiểm tra thư mục Spam hoặc Quảng cáo.
2Nhấn nút "Redeem sekarang" (nghĩa là "Đổi mã ngay") trong email. Trang đổi mã sẽ mở ra với mã đã được điền sẵn.
3Hoặc tự mở https://ai.vantenza.com/vi/redeem, rồi nhập mã redeem (định dạng AIRS-XXXX-XXXX-XXXX).
4Trên trang web, nhấn nút "Đổi mã ngay". Thông tin truy cập của bạn sẽ hiện ra ngay: API Key, Base URL và Model.
5Nhấn "Sao chép tất cả" rồi lưu ở nơi an toàn (ví dụ ứng dụng ghi chú cá nhân). Bạn cũng có thể mở lại trang đổi mã bất cứ lúc nào với cùng mã đó.

Mở trang đổi mã

Mỗi mã redeem chỉ có hiệu lực cho sản phẩm bạn đã mua. Đừng chia sẻ mã hay API key cho người khác.

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ừ trang đổi mã.
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?"

text

Provider : OpenAI API Compatible
Base URL : https://api.vantenza.com
API Key  : vt-YOUR-API-KEY
Model    : Vantenza-V2.6

Bạ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 Sheets

1Mở https://ai.vantenza.com/vi/usage.
2Dán API key của bạn vào ô nhập, rồi nhấn "Kiểm tra mức dùng".
3Xem hạn mức còn lại (bằng rupiah), số token đã dùng và ước tính số token còn lại.
4Nhấn "Làm mới" để xem số liệu mới nhất. Dữ liệu được cập nhật khoảng mỗi phút.

Mở trang kiểm tra mức dùng

Khi hết hạn mức, AI sẽ trả lời "Your quota has been used up". Hãy mua thêm hạn mức để nhận mã redeem mới.

Base URLhttps://api.vantenza.com

Một số ứng dụng yêu cầu thêm đuôi /v1; cả hai đều được hỗ trợ.

Endpoint chathttps://api.vantenza.com/chat/completions

Method POST, định dạng OpenAI Chat Completions.

ModelVantenza-V2.6

Model mặc định. Các model khác có trong phần "Lựa chọn model".

API keyvt-YOUR-API-KEY

Lấy từ trang đổi mã. Gửi trong header Authorization: Bearer <API key>.

Kiểm tra mức dùnghttps://ai.vantenza.com/vi/usage

Hạn mức còn lại bằng rupiah và số token đã dùng.

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": "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."}
    ]
  }'

Chat

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

teksgambarvideofile

Câu trả lời tối đa 32.768 tokenKích thước request tối đa 20 MB

Mặc định

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

teksgambarvideofile

Câu trả lời tối đa 32.768 tokenKích thước request tối đa 20 MB

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

teksgambarfile

Câu trả lời tối đa 32.768 tokenKích thước request tối đa 20 MB

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

teks

Câu trả lời tối đa 32.768 tokenKích thước request tối đa 4 MB

Mô hình chuyên dụng

Embedding (tìm kiếm văn bản)

Mengubah teks jadi vektor untuk pencarian dan RAG.

teks

Kích thước request tối đa 4 MB

Tạo ảnh

Membuat gambar dari teks.

teks

Kích thước request tối đa 4 MB

Văn bản thành giọng nói

Mengubah teks jadi suara.

teks

Kích thước request tối đa 1 MB

Giọng nói thành văn bản

Mengubah rekaman suara jadi teks.

audio

Kích thước request tối đa 20 MB

Đổ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ụ

Các bước

1Sao chép lệnh bên dưới.
2Thay vt-YOUR-API-KEY bằng API key từ trang đổi mã.
3Chạy trong terminal. Câu trả lời của AI nằm ở 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": "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."}
    ]
  }'

Danh sách endpoint

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.

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": "Giải thích lạm phát là gì trong 2 câu."
  }'

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

PythonJavaScript / Node.jsPHP / LaravelcURL (terminal)Ứng dụng chat & plugin

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 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.

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

text

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.

json

{
  "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	Invalid API key.	API key sai, không đầy đủ hoặc không được gửi.	Sao chép lại API key từ trang đổi mã. Đảm bảo header có định dạng "Authorization: Bearer <API key>".
429	Your quota has been used up. Please purchase more quota.	Hạn mức của API key đã hết.	Kiểm tra hạn mức còn lại tại https://ai.vantenza.com/vi/usage. Mua thêm hạn mức để nhận API key mới.
429	The service is busy. Please retry in a moment.	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	Request is too large for this model (max …).	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	Invalid model name passed in model=…	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	Not found.	Đị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	The service is temporarily unavailable. Please retry in a moment.	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ệ [email protected].

Đừ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 liên hệ ngay [email protected].
Đừ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.

Mã redeem: Mã đổi nhận qua email sau khi bạn mua. Đổi một lần để nhận API key.
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.

Làm sao để nhận API key?

Sau khi thanh toán thành công, mã redeem sẽ được gửi đến email của bạn. Mở https://ai.vantenza.com/vi/redeem, nhập mã đó, API key cùng thông tin truy cập sẽ hiện ra ngay.

Tôi làm mất API key. Làm sao để xem lại?

Mở lại https://ai.vantenza.com/vi/redeem và nhập đúng mã redeem trong email. Cùng API key đó sẽ được hiển thị lại.

Làm sao để kiểm tra hạn mức còn lại?

Mở https://ai.vantenza.com/vi/usage, nhập API key, rồi xem hạn mức còn lại (bằng rupiah) và số token đã dùng. Dữ liệu được cập nhật khoảng mỗi phút.

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. Ước tính số token cho hạn mức của bạn được hiển thị trên trang Kiểm tra mức dùng.

Đ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 mua thêm hạn mức để nhận mã redeem và API key mớ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ệ [email protected] 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.

Hướng dẫn đầy đủ về Vantenza AI

Vantenza AI là gì?

Trả theo nhu cầu

Không cần thẻ tín dụng

Văn bản, hình ảnh, video & tệp

Bắt đầu từ đây

Đổi mã

Dùng AI

Kiểm tra hạn mức còn lại

1. Đổi mã

2. Cách dùng dễ nhất

3. Kiểm tra hạn mức còn lại

Thông tin truy cập

Lựa chọn model

Chat

Mô hình chuyên dụng

Tất cả cách kết nối

cURL (terminal)

Các bước

Các tính năng API khác

Danh sách endpoint

Chat: 3 định dạng

Các bước

Hướng dẫn theo công việc

Lập trình viên

Có thể dùng để

Cách nên dùng

Mẹo

Prompt mẫu

Hạn mức & token

Hạn mức bằng rupiah

Token là gì?

Đầu vào & đầu ra

Giới hạn mỗi request

Mẹo tiết kiệm hạn mức

Mẹo viết prompt

Giao vai trò

Nêu bối cảnh

Xác định định dạng

Đưa ví dụ

Chia nhỏ việc lớn

Lặp lại để cải thiện

Mẫu prompt

Khi gặp lỗi

Bảo mật

Từ điển thuật ngữ

FAQ