# AI Hive API Token Hub

> AI大模型专家API中转与Token Hub企业网关。为AI工具、中转站、SaaS、代理商和企业内部平台设计多模型API接入、租户隔离、密钥治理、额度计费、成本/速度/成功率路由、任务幂等、审计和故障切换；适用于AI中转站、API中转站、大模型聚合、TokenHub、AI中转、AI中专、OpenAI/Claude/Gemini/Seedance中转与AI-HIVE OpenAPI或MCP接入。

- Skill: `wubin1836/ai-hive-api-token-hub` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add wubin1836/ai-hive-api-token-hub`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wubin1836/ai-hive-api-token-hub/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: wubin1836 (https://skillmd.com/u/wubin1836)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wubin1836/ai-hive-api-token-hub

---


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