文档
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-cn/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将模型填为: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-cn/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(终端)
直接在终端(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 功能:聊天机器人、自动摘要、工单分类、数据提取。
- 解释、审查和整理代码。
- 编写单元测试、文档和提交信息。
- 根据自然语言描述编写 SQL 查询和正则表达式。
- 把自由文本转换为结构化 JSON。
推荐方式
小贴士
- 使用“system”角色消息来统一设定角色和回答格式。
- 要求结构化格式(“只回复 JSON”),方便程序处理结果。
- 每个请求的回答长度受模型限制(见“模型选择”)。需要长篇结果时,请拆成多个请求。
- 将 API key 保存在环境变量或密钥管理器中,不要放进代码仓库。
提示词示例
你是一名资深软件工程师。请审查以下代码:找出 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 格式写一条提交信息(标题不超过 72 个字符): [粘贴 git diff]
额度与 token
了解额度的计算方式,用得更省。
以印尼盾计算额度
API key 的额度等于您支付的金额。每个请求会按处理的 token 数量扣减额度。
什么是 token?
token 是词语的片段。大约 1 个 token ≈ 4 个英文字符;印尼语每个词通常会占用稍多一些 token。
输入与输出
输入是您发送的所有文本(包括对话历史)。输出是 AI 的回答。输出 token 更贵,因此尽量让 AI 回答得简洁一些。
单次请求限制
每个模型都有各自的回答长度和请求大小上限(见“模型选择”)。图片、视频和文件也计入输入 token。
节省额度的小技巧
- 要求简短、具体的回答,例如“最多 3 点”或“用一个词回答”。
- 只发送文档中相关的部分,而不是整个文档。
- 限制对话历史:只发送最近几条消息。
- 把相同问题的回答保存(缓存)起来,避免重复发送。
提示词写作技巧
回答的质量很大程度上取决于您的提问方式。请参考以下方法。
设定角色
先说明 AI 的角色,例如“你是一名经验丰富的会计师”。
说明背景
讲清目的、受众和相关背景信息。
指定格式
说明回答的形式:要点、表格、JSON 或具体字数。
给出示例
提供一两个期望结果的示例,能让回答更加一致。
拆分大任务
先让 AI 列出大纲,再逐部分展开。
反复迭代
用追加消息来改进:“再短一点”“更正式一些”“加个例子”。
提示词模板
角色:你是[角色,例如经验丰富的财务分析师]。
背景:[背景和目的]。
任务:[需要完成什么]。
格式:[要点 / 表格 / 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。确保请求头格式为“Authorization: Bearer <API key>”。 | |
| 429 | API key 的额度已用完。 | 在 https://commerce.vantenza.com/zh-cn/account/ai 查看剩余额度,然后为同一个 key 充值。API key 不会改变。 | |
| 429 | 短时间内请求过多。 | 等待几秒后再试。如果是程序调用,请加入间隔并自动重试(带退避的重试)。 | |
| 413 | 请求内容(文本、对话历史、图片、视频、文件)超出了模型上限。 | 缩小或压缩文件、分段发送文档、减少对话历史,或改用上限更大的模型。 | |
| 400 | 模型名称错误,或该模型当前未启用。 | 请使用“模型选择”部分中的名称,例如“Vantenza-V2.6”。模型名称区分大小写。 | |
| 404 | 端点地址错误。 | 请使用 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 保存在环境变量、密钥管理器或脚本属性(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-cn/account/ai)中,并附有其额度。
我的 API key 丢了,怎样重新查看?
登录您的账户,打开 https://commerce.vantenza.com/zh-cn/account/ai,点击“显示 key”并输入账户密码。如果 key 可能已泄露,请使用“更换 key”:旧 key 会停止工作,额度保持不变。
如何查询剩余额度?
打开 https://commerce.vantenza.com/zh-cn/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