Skip to content

项目管理

租户控制台 → 项目管理

项目是组织内的资源与预算单元:把一组 API Key 归入项目,项目的消费自动汇总,配合预算上限实现项目级成本核算与熔断。适合「一个项目 / 产品 / 客户一条预算线」的组织方式。

项目消费与成员额度并行校验:用项目 Key 发起的请求同时计入项目预算,预算耗尽后项目下所有 Key 停止服务。

创建与编辑项目

字段说明
项目名称必填
描述选填
预算上限(USD)0 = 不限制;达到上限后项目下所有 Key 将停止服务

预算可在项目详情页随时调整(提高预算立即恢复服务)。

项目状态

状态说明
活跃正常服务
预算耗尽消费达到预算上限,项目下 Key 全部停止服务;提高预算后自动恢复
已归档手动归档,项目下所有 Key 立即失效;可取消归档恢复

归档的影响

归档是软性下线项目的方式,但会即时停掉项目下全部 Key——正在使用这些 Key 的应用会立刻收到错误。归档前确认没有生产流量在用。

项目详情

详情页由「基本信息 / API 密钥 / 用量统计」三个 Tab 组成,分别对应下文的概览、项目密钥与用量。

租户控制台 — 项目详情

概览

项目基本信息、预算使用进度(按月消费 / 预算计算,70% 起变黄、90% 起变红)、活跃 Key 数、本月请求数与消费汇总。

项目密钥

项目级 API Key 的完整管理:创建、编辑、复制明文、禁用,表单与个人 Key完全一致(名称、有效期、可用模型、QPS / 并发 / 额度、IP 白名单)——但额度与消费计入项目而非某个成员。

项目 Key 的典型用法:

  • 应用接入生产环境,Key 不属于任何个人,人员变动不影响应用;
  • 一个项目对应一个产品线,成本直接从项目用量报表读出;
  • 项目 Key 可再设自身额度上限,形成「项目预算 → Key 额度」双重控制。

用量

项目维度的消费统计与请求日志明细,用于对账与成本分摊。

典型场景

  • 按产品线核算 —— 为每个产品建项目,月底从各项目用量导出成本报表;
  • 外部交付 —— 给客户的接入 Key 放独立项目并设预算,费用隔离、超支自动停;
  • 试探性任务 —— 一次性批量任务单独建项目,设小额预算兜底。

相关文档

基于 AGPL-3.0 许可发布