教程更新
仅实现已获准入组织的官方账务 Beta;真实 Key 创建、准入、组织范围、后台导航与费用对账待用户测试,不为监控申请准入、充值或更改权限。
- 所需凭据
- 独立非 Legacy 项目 API Key
- 监控币种
- USD · 美元费用,非余额
- 可以看到什么
- 本 UTC 月组织已报告费用
- 固定 GET https://api.together.ai/v1/billing/usage,Bearer 认证,显式固定 organization_id、当前 UTC 月、granularity=hour 与所有分页。直接汇总 line_items[].cost 美元十进制字符串,例如 0.125 就是 $0.125,不除以 100,不按数量乘单价重算。balanceAmount=null;togetherCost.latestWindowEnd 是已报告小时的不含终点 UTC 时间,不代表完整发票或实时余额。
不提供 Key,在官方手动查看
- 进入既有组织 Billing,核对组织与 Credit balance;不要充值或变更 auto-recharge 来测试。
- Monthly spend → See current monthly invoice usage,或有现成访问权限时用组织 Cost analytics。选同一 UTC 月与全部使用量,区分费用和余额。
- 记录时间与金额并考虑完成小时/延迟;无 Beta、不能接受普通 Key 风险或无控制台权限时停止,不为本站申请更高权限。
在 Quota Monitor 中接入 Together AI · 组织费用(Beta)
先确认现有组织与 Beta 准入
打开下方组织设置,确认实际承担 Together 费用的现有组织。账务 API 需要该组织已经获准 billing usage Beta;不为接入更换组织、接受邀请、购买 Credits、申请新增权限或升级套餐。
尚未开通时先用下方官方账务手动查询。预付平台的既有购买要求不等于本站要求充值;本教程不会发起支付、自动充值或收费模型测试。
判断普通 Key 的风险是否可接受
Together 尚无公开的账务单动作只读 Key。普通项目 Key 能使用该项目资源并产生费用;Beta 还允许 external collaborators 的项目 Key 读取整个组织报表,项目范围不能隔离账务。
既有 project editor 即可创建 Key,不需要改为 admin;组织 Cost analytics 控制台仅管理员可看,与此 API 的访问范围不同。安全要求不能接受时停止并手动查账,不伪造只读权限配置或绕过审批。
在现有项目创建独立非 Legacy Key
打开目标项目的 API keys settings,选择 Create API Key,名称可填 QuotaMonitorCosts。如需有效期,勾 Set an expiration date 并选择合适日期,再点击 Create,立即私下保存完整 Key。
不使用 Deprecated 的 Legacy Key,不再生或撤销业务 Key。名字和到期时间不让新 Key 变为只读,也没有可导入的官方 IAM JSON;不要截图、写入聊天或放进 URL。
私下读取并确认 organization_id
在自己不共享、不云同步、不记录请求历史的本地 HTTP 工具中,新建 GET https://api.together.ai/v1/whoami。仅在该工具的 Authorization: Bearer 请求头填本人 Key,不加请求体,不允许重定向,不把 Key 放进查询参数。
从成功 JSON 只复制 organization_id;它不是 project_id、project_slug、api_key_id 或组织显示名称。核对返回的组织名称与第 1 步相同后关闭工具。本站不会调用 whoami,也不收集这些身份明细;失配或失败就停止,不切换组织或复制 Cookie。
在 Quota Monitor 项目安全录入
进入本站目标项目,添加连接,选择「Together AI · 组织费用(USD,Beta)」。填写可识别名称,在遮蔽凭据框填完整普通 Key,并在必填组织 ID 框填第 4 步 organization_id,币种固定 USD。
该 ID 仅固定报表所属组织,不是项目过滤;每页都显式发送并核对它。不要填写 URL、project_id 或 Key ID。凭据加密存储;帮助抽屉与本教程共用正文,打开帮助不会提交连接或发请求。
等首次成功并核对同月费用
保存后等待首次同步或使用已有刷新入口,确认成功查询时间更新。将 costAmount 和官方同组织、同 UTC 月的已报告费用对比:0.125 表示 $0.125,保留小数与带符号调整,不按美分再除 100。
togetherCost.latestWindowEnd 显示已报告到的小时终点(不含该时刻),本月最多延迟一小时。REST/MCP 使用同一共享快照;404、缺字段、错误币种或不完整分页都失败并保留旧值,不当零。
区分余额、控制台筛选与内部预算
在组织 Billing 的 Monthly spend 卡片选择 See current monthly invoice usage;可访问组织 Cost analytics 时,选当前 UTC 月、Cost ($)、All usage,并考虑完成小时和一小时延迟。不要拿默认 Last 30 Days 或项目筛选结果作组织费用。
Credit balance、auto-recharge 和账单总额另看;当前官方控制没有独立按 Key 的花费上限,名称或到期时间也不会产生限额。本站不读取余额/上限,unsupported 不等于未配置。可选内部预算只计算参考差额,不改变 Together 资金与权限,也不保证模型可用。
轮换、到期与错误排查
仅为监控新建同组织非 Legacy 替代 Key,通过本站安全更新入口替换,成功同步后再撤销旧监控 Key。移除创建者的项目成员资格不会自动撤销 Key;不要动其他应用的 Key。
401 核对完整 Key、撤销与到期;403 核对 Key 所属组织与 organization_id;404 核对既有 Beta 准入,429 等待退避。只报告错误码和时间,不能通过充值、扩权或猜测余额端点排错;Beta 变化时先手动查账。
Quota Monitor 读取的 Together AI · 组织费用(Beta) 数据范围
- 只支持现有、已启用 billing usage Beta 的组织,未获准入返回 404;这不是零费用。Beta 响应可能变化,失败保留旧成功快照和时间,不猜新字段、不提取网页 Cookie。
- 只取当前 UTC 月完成的小时窗口,费用最多延迟一小时;过去月份可延迟 24 小时,但本站不查询过去月份。分页是移动快照,不是原子发票,不保留产品、资源、项目或 Key 明细,不从项目归属字段推算子项目费用。
- 没有钱包余额或供应商消费上限读取契约;officialLimit=unavailable/unsupported,不代表 not_configured、无限调用或 Credits 为零。内部预算差额仅参考,不是资金,不改变供应商限制,也不推算耗尽日期。
- 面板展示最近一次成功的费用快照。刷新无法消除上游账务延迟;失败后保留的旧费用和旧时间不是新报表。
Together AI · 组织费用(Beta) 常见问题与排查
- 404 是否表示当月费用为零?
- 不是。官方账务 Beta 需按组织启用,未开通返回 404。本站保留旧快照;不要换成未公开端点、Cookie 或充值来尝试。
- 为什么项目 Key 读到全组织费用?
- 这是当前官方 Beta 的明确范围,包括外部协作者的项目 Key。不能限制为仅管理员或假定项目隔离;该能力不能接受时使用人工查询。未来范围收紧可能需要手动换钥,不会自动申请新权限。
- organization_id 从哪里获取?
- 本人在非共享本地工具中按第 4 步调用官方 GET /v1/whoami,只复制返回的 organization_id。不是 project_id、slug 或 Key ID,本站不调用该身份接口。403 先检查 ID 与 Key 属于同一组织。
- 为何与刚刚调用或控制台图表不一致?
- 只报告完成的 UTC 小时,本月最多延迟一小时。控制台默认 Last 30 Days、项目/Key 归属和筛选可与组织总额不同;选同月全部费用并核对 reported through。不要按 Token 单价估算补齐。
- 可用余额和官方上限为什么为空?
- cost 是美元已报告费用,不是剩余 Credits。无公开读取契约的上限标 unsupported,不是 not_configured;内部预算差额只是参考,不是实时可调用余额。
- Key 到期、401 或 Beta 返回变化怎么办?
- 核对独立 Key 的到期/撤销及组织范围,按教程换钥;429 等待退避。畸形或不完整分页全部失败,旧成功金额与时间不变。真实账号、后台步骤与金额仍待用户验证,不发送原始响应或 Secret。
Together AI · 组织费用(Beta) 官方资料
- 官方账务 API:USD、Beta、组织范围与分页(在新标签页打开)
- 官方 Key 创建、有效期及 Legacy 风险(在新标签页打开)
- 官方身份读取与 organization_id(在新标签页打开)
- 官方组织账务边界(在新标签页打开)
- 官方角色与外部协作者权限(在新标签页打开)
- 官方花费控制与 Beta 延迟(在新标签页打开)
- 官方费用图表与 UTC 对账(在新标签页打开)
- 官方 Credits 与现有账户前提(在新标签页打开)
教程由 Quota Monitor 整理,非供应商官方教程。平台界面和权限可能变化,请以官方页面为准;实测范围以本页说明为准。