简
购买额度
文档

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-cn/redeem，然后输入兑换码（格式为 AIRS-XXXX-XXXX-XXXX）。
  4. 4点击网页上的“立即兑换”按钮。您的访问信息会立即显示：API Key、Base URL 和模型。
  5. 5点击“全部复制”，然后保存在安全的地方（例如私人笔记应用）。您也可以随时用同一个兑换码再次打开兑换页面。
打开兑换页面

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将模型填为：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-cn/usage。
  2. 2将您的 API key 粘贴到输入框中，然后点击“查询用量”。
  3. 3查看剩余额度（以印尼盾计）、已用 token 数量和预计剩余 token。
  4. 4点击“刷新”查看最新数据。数据大约每分钟更新一次。
打开用量查询

访问信息

在任何支持 OpenAI 格式的应用或代码中使用以下值。

Base URLhttps://api.vantenza.com
有些应用要求加上 /v1 后缀；两种写法都支持。
聊天端点https://api.vantenza.com/chat/completions
POST 方法，OpenAI Chat Completions 格式。
模型Vantenza-V2.6
默认模型。其他模型见“模型选择”部分。
API keyvt-YOUR-API-KEY
来自兑换页面。通过请求头 Authorization: Bearer <API key> 发送。
查询用量https://ai.vantenza.com/zh-cn/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（终端）

直接在终端（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 功能：聊天机器人、自动摘要、工单分类、数据提取。
  • 解释、审查和整理代码。
  • 编写单元测试、文档和提交信息。
  • 根据自然语言描述编写 SQL 查询和正则表达式。
  • 把自由文本转换为结构化 JSON。

推荐方式

PythonJavaScript / Node.jsPHP / LaravelcURL（终端）聊天应用与插件

小贴士

  • 使用“system”角色消息来统一设定角色和回答格式。
  • 要求结构化格式（“只回复 JSON”），方便程序处理结果。
  • 每个请求的回答长度受模型限制（见“模型选择”）。需要长篇结果时，请拆成多个请求。
  • 将 API key 保存在环境变量或密钥管理器中，不要放进代码仓库。

提示词示例

代码审查

你是一名资深软件工程师。请审查以下代码：找出 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 个城市，然后简要说明它的原理。

提交信息

根据以下改动，按 Conventional Commits 格式写一条提交信息（标题不超过 72 个字符）： [粘贴 git diff]

额度与 token

了解额度的计算方式，用得更省。

以印尼盾计算额度

API key 的额度等于您支付的金额。每个请求会按处理的 token 数量扣减额度。

什么是 token？

token 是词语的片段。大约 1 个 token ≈ 4 个英文字符；印尼语每个词通常会占用稍多一些 token。

输入与输出

输入是您发送的所有文本（包括对话历史）。输出是 AI 的回答。输出 token 更贵，因此尽量让 AI 回答得简洁一些。

单次请求限制

每个模型都有各自的回答长度和请求大小上限（见“模型选择”）。图片、视频和文件也计入输入 token。

节省额度的小技巧

  • 要求简短、具体的回答，例如“最多 3 点”或“用一个词回答”。
  • 只发送文档中相关的部分，而不是整个文档。
  • 限制对话历史：只发送最近几条消息。
  • 把相同问题的回答保存（缓存）起来，避免重复发送。

提示词写作技巧

回答的质量很大程度上取决于您的提问方式。请参考以下方法。

设定角色

先说明 AI 的角色，例如“你是一名经验丰富的会计师”。

说明背景

讲清目的、受众和相关背景信息。

指定格式

说明回答的形式：要点、表格、JSON 或具体字数。

给出示例

提供一两个期望结果的示例，能让回答更加一致。

拆分大任务

先让 AI 列出大纲，再逐部分展开。

反复迭代

用追加消息来改进：“再短一点”“更正式一些”“加个例子”。

提示词模板

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。确保请求头格式为“Authorization: Bearer <API key>”。
429Your quota has been used up. Please purchase more quota.API key 的额度已用完。在 https://ai.vantenza.com/zh-cn/usage 查询剩余额度。再次购买额度即可获得新的 API key。
429The service is busy. Please retry in a moment.短时间内请求过多。等待几秒后再试。如果是程序调用，请加入间隔并自动重试（带退避的重试）。
413Request is too large for this model (max …).请求内容（文本、对话历史、图片、视频、文件）超出了模型上限。缩小或压缩文件、分段发送文档、减少对话历史，或改用上限更大的模型。
400Invalid model name passed in model=…模型名称错误，或该模型当前未启用。请使用“模型选择”部分中的名称，例如“Vantenza-V2.6”。模型名称区分大小写。
404Not found.端点地址错误。请使用 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 保存在环境变量、密钥管理器或脚本属性（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-cn/redeem，输入该兑换码，API key 及其访问信息就会立即显示。

我的 API key 丢了，怎样重新查看？

重新打开 https://ai.vantenza.com/zh-cn/redeem，输入邮件中的同一个兑换码，就会再次显示同一个 API key。

如何查询剩余额度？

打开 https://ai.vantenza.com/zh-cn/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”模型来节省额度，编程或复杂分析则用更智能的模型。所有模型共用同一份额度；更智能的模型消耗得更快。

我的数据安全吗？

请避免发送敏感数据，例如密码、银行卡号、完整的银行账号或他人的个人信息。发送前请先对数据做匿名化处理。