教程更新
依据官方文档实现,真实账号待验收;建 Key、权限、工作空间选择及控制台金额仍需用户实测。自动化检查不能替代真实验收。
- 所需凭据
- Segmind API Key
- 监控币种
- USD · 美元计价 Credits
- 可以看到什么
- 工作空间 Credits · 美元
- 固定 GET https://api.segmind.com/v1/get-user-credits,读取上游 Personal 或团队工作空间的 credits(scope=provider_workspace)。官方计费页面以美元表示 Credits:credits=25 展示 $25;不是本站项目独立钱包或成员消费限额。
不交出 Key,手动查看 Segmind Credits
- 登录官方控制台,用左下角切换器选择付款的 Personal 或团队工作空间。
- 打开 Billing 查看 Credits Balance,不看 Cost Analytics 已花费用或成员日/周/月上限。
- 待进行中任务或授权付款结算后再次核对。手动查询无需向 Quota Monitor 发送凭据。
在 Quota Monitor 中接入 Segmind
选择实际付款的工作空间
登录 platform.segmind.com,点击左下角工作空间切换器,选择应用实际使用的 Personal 或团队,再打开 Billing。
检查工作空间名称与 Credits Balance;接入监控不需要创建团队、调用模型或先购买额度。
打开 API Keys 页面
点击左侧导航底部 Developer,再进入 API Keys,使用页面的新建密钥操作创建独立监控 Key。
不要修改已有业务 Key。官方格式是 SG_ 加 16 个十六进制字符;JWT、Key 名称和遮蔽后缀都不是密钥。
创建前检查权限风险
如果创建表单提供名称,填写易识别的 Quota Monitor balance;检查新 Key 提供的模型访问与到期控制,然后完成创建。
公开文档未确认余额专用 scope 或禁止全部模型的策略。不要认为 Member 角色、消费上限或空模型列表就等于只读;不能接受风险时使用下方手动查询。
安全保存完整秘密值
在新 API Key 可见时复制并存入安全位置,确认它属于目标 Personal 或团队工作空间。
只复制值,不带 x-api-key:、引号;不要放进聊天、URL 或截图。遗失时创建替代 Key,不要暴露另一个应用的生产 Key。
在项目内添加连接
回到 Quota Monitor,打开目标项目 → 添加供应商连接 → 新建连接 → Segmind(USD),填写易识别名称,将 Key 粘贴到遮蔽 API Key 字段并保存。
不需要工作空间 ID、自定义地址或供应商项目/Key 筛选。本站项目只组织监控,不会拆分 Segmind 的共享资金。
完成首次同步对账
等待首次同步,或冷却结束后刷新一次;确认新的成功查询时间,在同一工作空间 Billing 中核对余额。credits=25 应显示 $25,不是 $0.25。
free-credits=2 单独显示,不变成总额 $27。REST/MCP 的 segmindBalance.balance 应与卡片主金额一致;比较相近时间,允许官方页面四舍五入差异。
金额不足时打开官方账单
点击卡片「前往平台」打开 Billing,先确认当前登录工作空间,再由获授权的人决定使用 Recharge 或查看 Auto-recharge。
本站不付款、不改自动充值。等待官方入账后再刷新;成员上限和模型访问限制与余额分开判断。
轮换或停止监控
常规轮换时创建新的独立 Key,在安全表单更新原连接,确认同步后到 Developer → API Keys 撤销旧监控 Key;怀疑泄露时立即撤销。
移除项目关联不会撤销上游 Key,也不等于删除其他项目共用的连接。分别处理这些操作,不改无关业务密钥。
Quota Monitor 读取的 Segmind 数据范围
- credits 是主可消费金额,free-credits 单独返回,文档没有说明它与充值或订阅资金的加总关系。不相加、不猜现金/赠金拆分、不套用其他平台的 Credits 比例。
- 多个 Key 和本站项目可能共享同一上游工作空间资金,不能重复汇总或再次减去已花费用。对账时切到相同上游工作空间。
- 只做免费余额 GET,不调用模型、登录会话、密钥管理、充值或权限修改。公开 REST/MCP 的 segmindBalance.balance 和 freeCredits 来自同一快照。
- 查询时间不是结算时间。进行中任务可能预留资金但可见余额尚不变;成员限额、模型限制也会拒绝调用。正余额不保证模型可用。
- 零和负数保留;缺字段、格式错误和失败保留上次成功金额与时间,不造零。Credits 是服务资金,不是可提现现金。
- 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商,但不保证上游账务没有入账延迟;失败时旧余额不能当成新结果。
Segmind 常见问题与排查
- 401 或 403 怎么处理?
- 到 Developer → API Keys 检查完整 SG_ Key 是否有效。不要换成登录 JWT 或 Cookie,也不要盲目扩权、借业务生产 Key 绕过错误。权限仍不清楚时手动查账。
- 404 是什么意思?
- 官方余额接口说明没有额度记录时返回 404。检查目标工作空间 Billing 或咨询 Segmind;这不代表资金为零,本站不会尝试私有接口。
- 为什么赠送额度不加进去?
- 官方定义 credits 为控制台可消费金额,同时单独返回 free-credits,但没有提供相加规则。必须单列;不能认定为可退款现金或无条件模型权限。
- 团队金额为什么对不上?
- 确认 Key 对应的工作空间,并在控制台选中相同 Personal/团队;不要拿另一团队、Cost Analytics、成员上限或本站项目预算比较。进行中任务完成后再核对。
- 429 或 invalid_response 之后怎么办?
- 等待下一次允许的刷新。拒绝或不完整响应保留原成功快照与时间,不生成新的零余额。只向支持反馈脱敏错误码和时间,不发送 Key。
- 真实账号验收通过了吗?
- 尚未。请验证创建流程与权限、Personal/团队范围及首次同步金额,再用官方 Billing 对照卡片和 REST/MCP。同样,部署和模拟测试不等于真实验收。
Segmind 官方资料
- Segmind 官方文档 · platform/account-and-billing-apis(在新标签页打开)
- Segmind 官方文档 · get-started/authentication(在新标签页打开)
- Segmind 官方文档 · platform/settings(在新标签页打开)
- Segmind 官方文档 · platform/teams(在新标签页打开)
- Segmind 官方文档 · platform/pricing-and-billing(在新标签页打开)
教程由 Quota Monitor 整理,非供应商官方教程。平台界面和权限可能变化,请以官方页面为准;实测范围以本页说明为准。