核心用法
Smart Spawn API 是一个模型路由服务，通过简单的 HTTP 端点帮助开发者自动选择最适合特定任务的 AI 模型。核心工作流为：调用 /api/pick 传入任务描述和预算等级，获取推荐模型 ID，然后将其用于 sessions_spawn 或其他调用接口。
主要功能包括：
- 模型推荐 (
/api/pick)：根据任务类型（coding、reasoning、creative、vision 等）和预算（low/medium/high/any）返回最优模型 - 批量推荐 (
/api/recommend)：返回多个来自不同供应商的候选模型，适用于并行或集体决策场景 - 模型对比 (
/api/compare)：并排展示指定模型的评分、价格和综合能力 - 模型浏览 (
/api/models)：按分类、评分、成本等维度筛选全部可用模型 - 任务分解 (
/api/decompose)：将复杂任务拆分为带最优模型分配的步骤序列 - 并行编排 (
/api/swarm)：生成依赖图，为并行子任务自动分配模型
显著优点
1. 零插件集成：纯 HTTP API，任何支持 HTTP 的客户端或 OpenClaw 实例均可直接调用
2. 预算感知：四档预算分级（$0-1/M 至 $2-20/M），避免过度配置或性能不足
3. 多维度评估：综合 5 个基准源，每 6 小时刷新评分数据
4. 复杂任务支持：内置分解与并行编排能力，降低多步骤任务的手动规划成本
5. 灵活的排除与上下文机制：可屏蔽特定模型，或通过标签强化路由偏好
潜在缺点与局限性
- 外部依赖风险：API 服务由
ss.deeflect.com托管，可用性直接决定功能有效性；文档建议 429/404 时回退至默认模型 - 评分透明度有限：评分算法未公开，用户无法获知 86 分等具体指标的计算逻辑
- 供应商锁定隐忧：推荐结果偏向特定生态（如 Anthropic、OpenAI），新兴或小众模型可能曝光不足
- 实时性延迟：6 小时刷新周期对快速迭代的模型市场可能滞后
- 成本估算为区间值：pricing 字段仅提供分段区间，实际费用需二次确认
适合人群
- 需要动态模型选型的多代理系统开发者
- 预算敏感但不愿牺牲质量的 SaaS 产品团队
- 构建复杂工作流（代码生成 + 文档 + 测试）的自动化工程师
- 希望减少对单一模型依赖、探索多模型策略的技术决策者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 服务中断 | 建议实现降级逻辑（API 失败时跳过模型参数） |
| 评分偏差 | 基准源可能存在评估方法学差异，关键任务应交叉验证 |
| 成本超支 | 区间预算仅作参考，高 token 场景需额外监控 |
| 数据隐私 | 任务描述需经第三方服务器，敏感场景应脱敏处理 |