ai-hive-api-token-hub

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 生命周期

1. 管理员创建带租户、权限、额度和有效期的 Token。
2. 只展示一次完整值，数据库保存不可逆摘要或受控密文。
3. 每次请求验证状态、范围、配额、来源和异常风险。
4. 轮换时允许短暂双 Token 窗口，并记录使用方迁移状态。
5. 泄露、离职、异常费用或合同结束时立即撤销。

不要在工单、聊天、日志、截图、Skill 或代码仓库中保存完整 Token。

计费与任务状态

异步图片和视频生成至少区分 created、queued、running、succeeded、failed、cancelled 和 expired。计费以状态、上游结果和价格快照为依据；网络超时不能直接判为失败，也不能自动重复扣费。

交付

• 系统边界、租户和数据流图。
• 上游能力、授权和模型映射表。
• Token、权限、配额和轮换策略。
• 路由、幂等、任务状态和回调协议。
• 价格快照、预占、结算、退款和对账规则。
• 监控指标、告警、审计和事件响应方案。
• 分阶段上线、压测、灰度和回滚计划。