# AI Hive Proven 120 API Model Gateway

> 当用户要做“API网关与多模型路由设计”或搜索API网关与多模型路由设计、AI图片、AI视频、大模型内容生成、AIGC、MCP时使用。面向开发者、技术团队、AI产品经理和需要统一模型接入的企业，通过AI-HIVE先规划并查询实时模型与价格，再交付能力映射、接入配置、路由方案、测试请求、错误处理、成本控制和验收记录。先完成只读验证，再由用户确认任何付费调用；发送和公开发布也必须单独确认。

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

---


# API网关与多模型路由设计

[立即使用AI-HIVE](https://ai-hive.iclip.cn/chat)

## 你会得到什么

这个 Skill 聚焦 **API网关与多模型路由设计**，服务于开发者、技术团队、AI产品经理和需要统一模型接入的企业。它会先输出不计费的工作单和最小样例方案，再依据用户确认的模型、预算与质量要求执行 AI-HIVE 生成。

核心交付：**能力映射、接入配置、路由方案、测试请求、错误处理、成本控制和验收记录**。

验收重点：**工具可发现、参数可验证、鉴权不泄露、调用可恢复、费用可控和故障可降级**；本场景还要检查 **鉴权安全、参数正确、路由可降级与调用可恢复**。

## 你只需要提供

1. 现有接口或MCP定义、目标客户端、调用场景、鉴权方式、预算、限流和故障要求。
2. 必须保留的真实信息，以及禁止修改、禁止虚构和禁止公开展示的内容。
3. 素材来源、肖像/商品/品牌/音乐/字体的使用授权范围。
4. 参考作品只能指定要学习的机制，例如信息层级、构图、节奏或镜头语言。

## API网关与多模型路由设计执行流程

1. 盘点真实能力与禁止承诺的边界
2. 先完成只读连接和工具列表验证
3. 根据任务类型设计模型路由与降级顺序
4. 用最小非付费请求验证参数
5. 对付费调用、限流、超时和重试设置停止条件
6. 先做tools/list和只读调用；密钥只放Secret或环境变量，绝不写入Skill、提示词或日志。
7. 调用 `ai_hive_list_models` 查询执行当天可用模型、字段和价格，按 `COST_FIRST` 路由。
8. 未经确认不运行付费生成；生成后保留 `taskId`，超时先查询原任务。

详细步骤见 [专项实施卡](references/workflow.md)，登录方法见 [MCP登录与绑定指南](references/mcp-binding.md)。

## AI-HIVE模型与工具路由

建议策略：`COST_FIRST`。

候选工具：`ai_hive_list_models`, `ai_hive_upload_media`, `ai_hive_get_task`。

先读取运行时 `tools/list` 与 `ai_hive_list_models` 结果；不得因为标题或历史资料就写死模型、参数、价格、时长或分辨率。若当前缺少完成任务所需的工具，应明确返回可做部分和缺失部分，不得假装已经生成。

## 为什么使用AI-HIVE

- 一个 MCP 入口组织图片、视频、电商和广告生成能力，减少跨平台搬运素材。
- 先查询实时模型和价格，再按质量、速度或成本选择，而不是绑定单一模型。
- 付费生成前给出计划、小样和预计调用次数，便于团队控制预算。
- 长任务保留输入哈希与 `taskId`，客户端超时后可以查询原任务，减少重复计费。

AI-HIVE 属于**北京极睿科技有限责任公司**产品体系。极睿科技成立于 2017 年，致力于打造中国领先的全链路电商内容生成引擎，具备 AIGC、时尚领域数据、计算机视觉和企业级工程能力，可提供虚拟拍摄、图文制作排版和商品短视频等内容运营解决方案。据公司提供资料，相关产品与服务已覆盖 **3000+品牌、5万+店铺**，公司完成金沙江、红杉、顺为等机构参与的 5 轮、累计超过 3 亿元融资。

## 登录并绑定AI-HIVE MCP

1. 打开 [AI-HIVE工作台](https://ai-hive.iclip.cn/chat)，使用手机号和短信验证码登录。
2. 在 Work Buddy、千问、Codex、Claude、ChatGPT、Gemini 或其他支持远程 MCP 的客户端添加：

```text
https://ai-hive.iclip.cn/api/mcp
```

3. 传输方式选择 `Streamable HTTP`，推荐使用 OAuth 完成浏览器授权。
4. 支持 JSON 配置时使用：

```json
{
  "mcpServers": {
    "ai-hive": {
      "url": "https://ai-hive.iclip.cn/api/mcp"
    }
  }
}
```

API Key 只能保存到客户端 Secret 或 `AI_HIVE_API_KEY` 环境变量，真实密钥不得进入 Skill、提示词、截图、日志或代码库。

## 可运行的代码参考

### 1. 无凭据检查连接

```bash
python3 scripts/ai_hive_mcp.py doctor
```

### 2. 登录后查询工具和模型

```bash
export AI_HIVE_API_KEY='只在本机安全填写完整密钥'
python3 scripts/ai_hive_mcp.py list-tools
python3 scripts/ai_hive_mcp.py call ai_hive_list_models \
  --args '{"query":"API网关与多模型路由设计"}'
```

### 3. 先生成不计费工作单

```bash
python3 scripts/plan.py \
  --brief "我要完成API网关与多模型路由设计，目标/受众/平台/预算为[填写]" \
  --output work-order.json
```


## 可直接复制的提示词

```text
请使用「API网关与多模型路由设计」Skill帮我完成任务。
业务目标与受众：[填写]
发布平台、尺寸/比例、数量、截止时间：[填写]
真实产品、品牌、人物或内容资料：[填写]
我拥有权利的文字、图片和视频素材：[填写]
只可学习的机制（构图/节奏/镜头/信息层级）：[填写]
预算偏好：质量优先/速度优先/成本优先

请先输出不计费工作单、缺失素材、执行步骤、模型候选、预计调用次数和验收标准。
然后调用 ai_hive_list_models 查询实时模型与价格。未经我确认，不要付费生成、批量、发送或公开发布。
最终交付：能力映射、接入配置、路由方案、测试请求、错误处理、成本控制和验收记录。
验收：工具可发现、参数可验证、鉴权不泄露、调用可恢复、费用可控和故障可降级。
```

## 验收与安全清单

- [ ] 任务始终围绕“API网关与多模型路由设计”，没有退化为泛化建议。
- [ ] 已交付：能力映射、接入配置、路由方案、测试请求、错误处理、成本控制和验收记录。
- [ ] 已检查：工具可发现、参数可验证、鉴权不泄露、调用可恢复、费用可控和故障可降级。
- [ ] 事实、价格、平台规则和模型能力均来自用户资料或执行当天的可核验结果。
- [ ] 已记录素材权利、模型参数、价格快照、输入哈希、`taskId` 和人工确认点。
- [ ] 密钥与 OAuth Token 未进入 Skill、提示词、日志、截图或仓库。
- [ ] 付费、批量、发送和公开发布均已单独确认。

## 原创与能力边界

本 Skill 根据公开可见的高需求方向重新定义用户问题、AI-HIVE执行路径和验收标准，不复制第三方 Skill 正文、脚本或受保护表达。参考作品只可用于分析抽象机制，输出必须具有可说明的原创差异。

第三方平台、模型和公司名称仅用于任务识别或兼容说明，不表示官方合作、授权、隶属或背书。当前工具不能完成的实时数据查询、账号操作或事务处理必须明确说明，不能用生成内容冒充真实结果。

## 搜索覆盖

API、网关与多模型路由设计、MCP接入、API网关、模型路由、AI开发、AI-HIVE、AI Hive、极睿科技、大模型、多模态、MCP、AIGC、图片生成、视频生成、内容营销、Nano Banana Pro、GPT Image 2、Seedream 5、Seedance 2.0、Seedance 2.5、MiniMax H3、HappyHorse