概述
Skill Hub Gateway 是 BinaryWorks 推出的统一 AI 能力网关服务，采用"网关+能力"的模块化架构，为开发者提供标准化的异步执行与轮询工作流接口。通过单一 API 密钥即可调用覆盖计算机视觉、语音识别、语音合成、文档处理、向量化检索等六大领域的 30+ 项 AI 能力。
核心用法
异步执行模式：所有能力统一通过 POST /skill/execute 发起调用，返回 run_id 后立即释放连接，通过 GET /skill/runs/:run_id 轮询获取结果。终端状态仅 succeeded 与 failed 两种，成功返回 output，失败返回结构化错误 error。
快速接入：提供 scripts/execute.mjs 与 scripts/poll.mjs 零依赖 CLI 脚本，支持自动引导流程——自动生成安装码、完成 Bootstrap 获取 API 密钥、无需手动配置即可调用运行时 API。
多模态输入：图像能力支持 image_url（需直接图片文件 URL，非网页链接），ASR 支持 audio_url，文档转换支持 file_url。客户端上传的文件由运行时内部归一化为临时对象 URL。
版本管理：内置 Agent 端版本检查协议，通过 /skills/manifest.json 比对语义化版本，每日最多提示一次更新，支持「立即更新」或「稍后提醒」的用户决策流。
显著优点
- 统一接口：所有能力共享同一套执行/轮询契约，学习成本极低
- 开箱即用：CLI 脚本内置自动认证，新用户 30 秒内完成首次调用
- 弹性设计：纯异步架构天然支持长耗时任务（如视频分析），无超时风险
- 能力丰富：单网关覆盖目标检测、人像分割、关键点检测、情绪识别、OCR、TTS、嵌入向量等全栈需求
- 透明排障：2.3.1 起 CLI 错误输出包含
status/code/message/request_id结构化日志
局限性与潜在缺点
- CLI 脚本无上传功能：图像/音频需预托管为可下载 URL，或依赖宿主客户端的上传流
- 轮询依赖客户端：无 WebSocket 推送，需自行实现指数退避轮询策略
- 冷启动延迟：部分视觉模型首次调用可能有 2-5 秒预热时间
- 错误粒度有限：
failed状态仅返回高层错误码，底层模型细节需提工单排查
适合人群
- 快速原型开发者：需在短时间内验证多种 AI 能力组合
- 中台/平台团队：需为内部业务方统一封装 AI 服务层
- 自动化工作流构建者：CI/CD、批处理管道、无服务器函数场景
- 多语言栈团队：HTTP/JSON 接口，任意语言均可接入
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据隐私 | 敏感图像/音频上传至第三方网关，需评估合规要求 |
| URL 有效性 | `image_url` 等需确保公网可访问且未过期，失效将导致执行失败 |
| 版本漂移 | 2.3.0+ 引入自动更新检查，生产环境建议固定版本或禁用自动提示 |
| 配额耗尽 | 高频轮询可能消耗 API 调用配额，建议轮询间隔 ≥1 秒 |
| 网络依赖 | Bootstrap 与版本检查失败时服务降级，但核心执行仍依赖网关可用性 |