常见问题
汇总账户、接口地址、令牌、模型、错误处理、流式响应、计费、客户端与安全相关问题。
Veremart 的 API Base URL 是什么?
OpenAI 兼容接口地址为:
https://veremart.com/v1大多数兼容 SDK 和客户端填写该地址及你的 API 令牌即可。请不要在 Base URL 后重复添加 /v1。
现在可以自行注册账户吗?
当前 Veremart 未开放公开注册和密码注册。已有账户可以正常登录;账户开放范围如有调整,以登录页和控制台的实时提示为准。
如何创建和管理 API 令牌?
登录控制台后进入令牌管理,为不同应用分别创建令牌,并按需要设置名称、额度和有效期。
令牌只应保存在可信服务端;不要发送到聊天、截图、公开仓库、网页前端或日志。
应该选择哪个模型?
打开模型价格或控制台,复制当前令牌分组可用的准确模型名称。不同模型在对话、代码、分析、图像、上下文长度和响应速度方面各有侧重;具体可用模型以实时页面为准。
为什么提示模型不存在或无权限?
依次检查:
- 模型名称是否准确。
- 令牌所属分组是否允许访问该模型。
- 客户端是否自行替换了模型名。
- 该模型是否仍在实时列表中。
不要把文档中的 your-model 当作真实模型名称。
为什么返回 401 Unauthorized?
通常表示未提供令牌、Authorization 请求头格式不正确,或令牌已失效。请求头应使用:
Authorization: Bearer YOUR_API_KEY请检查令牌是否复制缺失、包含多余空格、已过期或已被删除。
为什么返回 403 Forbidden?
通常表示账户、令牌、分组或目标模型没有相应权限,也可能是额度或安全策略限制。请先查看控制台提示和调用日志,再核对令牌分组及模型访问范围。
为什么返回 429 Too Many Requests?
可能触发了请求频率、并发、额度或上游限制。请降低并发,检查账户额度和调用日志,并使用带上限和随机抖动的指数退避;不要无间隔地无限重试。
遇到 500、502、503 或超时怎么办?
这类错误通常与临时服务或上游状态有关。请记录请求时间、模型名称、状态码和请求 ID,稍后使用有上限的退避策略重试。
若持续发生,请在隐藏 API Key、请求正文中的敏感信息和个人数据后提供这些信息以便排查。
Veremart 支持流式响应吗?
兼容接口支持时可在请求中设置:
{
"stream": true
}客户端必须正确处理服务端发送事件中的 data 行、结束标记、连接中断和超时;具体能力仍取决于所选模型和实时服务状态。更多说明见流式响应。
用量和额度如何计算?
不同模型可能采用不同的输入、输出、缓存、分组倍率或固定价格规则。请在模型价格页查看当前规则,并在控制台调用日志中核对模型、用量和最终额度消耗;最终以系统实时记录为准。
如何配置 Cherry Studio、Cursor 或 OpenAI SDK?
请阅读对应指南:
通常需要填写 https://veremart.com/v1、你的 API 令牌,以及控制台当前可用的准确模型名称。
可以把 API Key 放在网页或移动端应用里吗?
不建议。网页前端和客户端应用中的长期密钥可能被提取。生产应用应通过可信后端代为调用,并为不同应用使用独立令牌、最小额度、有效期和定期轮换策略;发现泄露时应立即删除旧令牌。
AI 输出可以直接用于重要决定吗?
不建议。AI 输出可能不准确、不完整、过时或不适合具体情境。医疗、法律、金融、安全及其他高影响用途必须由具备资质的人员复核,不应把模型输出作为唯一决策依据。
如何获得更多帮助?
请先阅读错误排查和本页常见问题。仍无法解决时,请准备:
- 请求时间;
- HTTP 状态码;
- 模型名称;
- 请求 ID。
提交信息前必须隐藏邮箱、API Key、请求正文中的敏感数据和其他个人信息。