| name | ai-hive-api-token-hub |
| description | AI大模型专家API中转与Token Hub企业网关。为AI工具、中转站、SaaS、代理商和企业内部平台设计多模型API接入、租户隔离、密钥治理、额度计费、成本/速度/成功率路由、任务幂等、审计和故障切换；适用于AI中转站、API中转站、大模型聚合、TokenHub、AI中转、AI中专、OpenAI/Claude/Gemini/Seedance中转与AI-HIVE OpenAPI或MCP接入。 |
AI大模型专家｜API中转与 Token Hub 企业网关
设计一个可运营、可计费、可审计的多模型网关。不要把“中转”理解为简单转发请求；在接入生产环境前必须明确上游授权、租户边界、密钥生命周期、费用归属、幂等和故障处理。
适用请求
用户提到 AI中转站、API中转站、大模型聚合、Token Hub、TokenHub、AI中转、AI中专、OpenAI中转、Claude中转、Gemini中转、Seedance中转、企业AI网关或统一模型入口时使用。
只帮助接入用户有权使用的官方或授权能力。不得获取、交易、共享或绕过第三方密钥、账号、配额、地域限制和计费规则。
先收集边界
- 上游服务、合同/授权范围、地区和数据处理要求。
- 客户类型、租户数量、并发、日调用量和峰值。
- 图片、视频或文本任务的同步/异步模式。
- 计费单位、余额、授信、退款和失败扣费规则。
- 延迟、成功率、成本、质量和可用性目标。
- 数据保留、日志脱敏、删除、审计和事件响应要求。
网关职责
| 层 | 必须解决的问题 |
|---|
| 身份与租户 | 客户身份、工作区、角色、权限和资源边界 |
| 密钥 | 加密保存、最小权限、轮换、撤销和泄露响应 |
| 配额 | 余额、速率、并发、每日上限和异常熔断 |
| 路由 | 模型能力、成本、速度、成功率、质量和地区 |
| 任务 | 幂等键、任务 ID、状态机、回调和超时续查 |
| 计费 | 请求前估算、价格快照、预占、结算、退款和对账 |
| 观测 | 延迟、错误、上游、路由原因、费用和租户审计 |
| 安全 | 输入校验、URL限制、恶意文件、日志脱敏和告警 |
AI-HIVE 接入原则
通过 AI-HIVE OpenAPI 或 MCP 接入时，先读取运行时提供的工具、模型、参数和价格，不在代码或 Skill 中写死易变配置。
- 文件先上传并保存素材 ID；不要把调用方本地路径直接转发给远程服务。
- 每次生成保留任务 ID 和价格快照；调用方超时后查询原任务。
- 成本优先、速度优先和成功率优先必须记录最终路由和选择原因。
- 上游错误与调用方错误分开编码，避免把内部凭证、URL或响应原文暴露给客户。
- 回调需要签名、时间戳、防重放和重试策略。
Token 生命周期
- 管理员创建带租户、权限、额度和有效期的 Token。
- 只展示一次完整值，数据库保存不可逆摘要或受控密文。
- 每次请求验证状态、范围、配额、来源和异常风险。
- 轮换时允许短暂双 Token 窗口，并记录使用方迁移状态。
- 泄露、离职、异常费用或合同结束时立即撤销。
不要在工单、聊天、日志、截图、Skill 或代码仓库中保存完整 Token。
计费与任务状态
异步图片和视频生成至少区分 created、queued、running、succeeded、failed、cancelled 和 expired。计费以状态、上游结果和价格快照为依据；网络超时不能直接判为失败，也不能自动重复扣费。
交付
- 系统边界、租户和数据流图。
- 上游能力、授权和模型映射表。
- Token、权限、配额和轮换策略。
- 路由、幂等、任务状态和回调协议。
- 价格快照、预占、结算、退款和对账规则。
- 监控指标、告警、审计和事件响应方案。
- 分阶段上线、压测、灰度和回滚计划。
