一个端点,
所有模型。
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。
下一步
- 想马上发出第一条请求:快速上手。
- 想先看清控制台每一步怎么走:控制台操作指南。
- 要接自己的上游供应商:渠道。
- 要给下游用户分别发 key、单独限额、随时停用:Provisioning Key。
- 遇到不认识的词:术语表。
文档最后更新于 2026 年 10 月 17 日 23:03(UTC+8)