使用文档

一个端点,
所有模型。

Tare 是挡在你所有模型前面的一层 OpenAI 兼容网关 —— 我们的,和你自己带来的。一个 base URL、一把 key,每一个 token 都算得清。

快速开始开始之前

开始之前

这篇解决什么问题:在你动手创建第一把 key 之前,把账号、额度限制、key 类型这三件事 一次说清。

账号从哪来

你需要先有一个能登录 Tare 控制台的账号。

账号的开通方式、企业认证要求、审核时长、试用额度、充值与授信方式,以控制台提示或 Jamerly 团队确认的信息为准。

三道限制:账户余额、月度预算、Key 累计额度

花出去的钱会撞上三道互不重叠的限制:

限制管什么谁来设
账户余额这个账号是否欠费平台
月度预算本月消费上限,每月清零你
Key 累计额度单把 key 的总消费上限,用完不重置你

怎么理解这三者:

  • 账户余额只作用于平台模型。自有渠道(BYOK)的 token 由你直接付给供应商,所以余额为零不会 阻断自有渠道上的调用。
  • Key 上的额度上限独立于余额,限制的是单把 key 的消费额。失控的任务会停在上限,而不是耗尽 整个账户。
  • 额度用尽时返回的是专门的错误码(见 错误码),不是笼统的失败。

Key 累计额度不与月度预算合并,因为积分不会每月自动恢复。它管的是这把 key 从建到废的总额, 不是本月额度。

第一次创建哪种 key

Tare 有三种 key,用途互不重叠,用错类型是最常见的 403:

key 类型能调不能调
Inference key(推理 key)模型端点:chat、embeddings、图片、视频、/v1/models、/v1/generation母钥管理、对账
Provisioning key(母钥)/v1/keys/*:开、查、改、吊销子钥调模型、读账务
Reconciliation key(对账 key)/v1/integration/*:只读的账务/用量报表调模型、管理 key

第一次跑通请求,创建的是 Inference key(推理 key)。控制台路径:

Code / Terminal
Console → Tare → API Keys → Create

类型选 Inference,名称写清用途,例如 support-bot-production。

Tare 里 key 是治理的最小单位,没有「部门/项目」这一层。组织架构一旦建模,第一次重组就会 和现实脱节。代价是账单上只会出现 key 的名字,所以建 key 时把用途写清楚,否则认不出这笔钱 是谁花的。

完整 key 明文只出现一次

完整的 key 只在创建时显示一次,平台仅存储哈希。 丢失后任何人都无法找回,平台同样无法 恢复,只能重新创建。

创建后请立刻复制,保存到你的服务端密钥管理系统,不要放在浏览器前端。列表里之后只显示掩码, 形如 ak-…3f2a。

下一步

文档最后更新于 2026 年 10 月 17 日 23:03(UTC+8)