核心用法
Skill Hub Gateway 是一个统一网关技能，用于异步执行和轮询工作流。它通过标准化的 API 接口，让开发者能够调用多种 AI 能力。
安装授权流程：首次使用通过自动化脚本完成 onboarding——获取安装码、启动引导、获得 API Key 后即可调用运行时 API。也可手动提供 api_key 跳过此流程。
运行时合约（V2）：
- 执行：
POST /skill/execute提交任务 - 轮询：
GET /skill/runs/:run_id查询结果 - 终端状态：
succeeded返回output，failed返回error - 图像类能力要求
image_url必须是直接图片文件 URL
内置能力：人体检测、图像标签、语音合成（标准/低成本）、语音识别、文本嵌入、重排序、Markdown 转换等 8 项。
配套工具：提供 execute.mjs、poll.mjs、runtime-auth.mjs 三个 Node.js 脚本，以及 OpenAPI 规范和能力清单文件。
显著优点
1. 异步架构：非阻塞式任务提交，适合长耗时 AI 推理场景
2. 自动化授权：内置完整的 agent 注册和 API Key 获取流程，降低接入门槛
3. 多能力聚合：单一网关覆盖 CV、NLP、语音等多模态能力
4. 脚本化集成：Node.js 脚本可直接嵌入 CI/CD 或本地工作流
5. 版本规范化：V2 合约明确定义状态机，便于错误处理
潜在缺点与局限性
- 外部依赖强：必须联网访问
gateway-api.binaryworks.app，无法离线使用 - Node.js 环境限制：捆绑脚本依赖 Node 运行时，非 Node 生态需自行实现
- 异步复杂度：需自行实现轮询逻辑，无原生 WebSocket/SSE 推送机制
- 图像 URL 限制：要求直接文件 URL，增加了预处理成本
- 透明度不足：官方文档未公开各能力的底层模型、延迟 SLA 及定价策略
适合人群
- 需要快速集成多模态 AI 能力的开发者团队
- 已有 Node.js 技术栈、追求脚本化自动化的工程团队
- 能接受异步轮询模式、对实时性要求不极端严格的场景
常规风险
1. 网络可用性：网关单点故障将导致服务不可用
2. API Key 泄露：脚本参数传递存在日志暴露风险，建议配合 secrets 管理
3. 任务堆积：异步队列无公开深度指标，大流量时可能遭遇延迟飙升
4. 数据隐私：图像、语音等敏感数据上传至第三方网关，需评估合规性