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、权限、配额和轮换策略。
路由、幂等、任务状态和回调协议。
价格快照、预占、结算、退款和对账规则。
监控指标、告警、审计和事件响应方案。
分阶段上线、压测、灰度和回滚计划。