✓ Verified 💻 Development ✓ Enhanced Data

Smart Spawn

Pick the best AI model for any task using the Smart Spawn API.

Rating: 4.8 (344 reviews)
Downloads: 26,992 downloads
Version: 1.0.0

Overview

Pick the best AI model for any task using the Smart Spawn API.

Complete Documentation

View Source →

Smart Spawn API

Pick the best AI model for any task. Call the API, get a model recommendation, spawn with it.

No plugin required. Works with any OpenClaw instance or any HTTP client.

Quick Start

text

1. GET ss.deeflect.com/api/pick?task=<description>&budget=<tier>
2. Use the returned model ID in sessions_spawn

Pick Best Model

bash

GET https://ss.deeflect.com/api/pick?task=build+a+react+dashboard&budget=medium

Response:

json

{
  "data": {
    "id": "anthropic/claude-opus-4.6",
    "name": "Claude Opus 4.6",
    "score": 86,
    "pricing": { "prompt": 5, "completion": 25 },
    "reason": "Best general model at medium budget ($0-5/M) — score: 86"
  }
}

Then spawn:

text

sessions_spawn(task="Build a React dashboard with auth", model="anthropic/claude-opus-4.6")

Parameters

Param	Required	Description
task	Yes	Task description or category: coding, reasoning, creative, vision, research, fast-cheap, general
budget	No	low ($0-1/M), medium ($0-5/M, default), high ($2-20/M), any
exclude	No	Comma-separated model IDs to skip
context	No	Tags like vision,long-context for routing boost

Get Multiple Recommendations

bash

GET https://ss.deeflect.com/api/recommend?task=coding&budget=low&count=3

Returns diverse models from different providers. Use for collective/parallel spawning.

Compare Models

bash

GET https://ss.deeflect.com/api/compare?models=anthropic/claude-opus-4.6,openai/gpt-5.2

Side-by-side scores, pricing, capabilities.

Browse All Models

bash

GET https://ss.deeflect.com/api/models?category=coding&sort=score&limit=10

Sort by score, cost, efficiency, or any category name.

Decompose Complex Tasks

bash

POST https://ss.deeflect.com/api/decompose
{"task": "Build and deploy a SaaS app", "budget": "medium"}

Returns sequential steps with optimal model per step.

Swarm (Parallel DAG)

bash

POST https://ss.deeflect.com/api/swarm
{"task": "Research competitors and build pitch deck", "budget": "low"}

Returns a dependency graph of parallel tasks with models assigned.

Usage Pattern

For any task that needs a sub-agent:

Decide budget — low for cheap/fast, medium for quality, high for best available
Call /api/pick with the task description
Use the returned id as the model parameter in sessions_spawn
If task is complex — use /api/decompose or /api/swarm to break it into subtasks, spawn each with its recommended model

Error Handling

API down → skip model selection, use sessions_spawn without a model (falls back to default)
No model found (404) → widen budget to any and retry
Rate limited (429) → wait and retry, or fall back to default

API Status

bash

GET https://ss.deeflect.com/api/status

Shows model count, data freshness, source health. Data refreshes every 6 hours from 5 benchmark sources.

Installation

Terminal bash


openclaw install smart-spawn

Copied!

💻Code Examples

sessions_spawn(task="Build a React dashboard with auth", model="anthropic/claude-opus-4.6")

sessionsspawntaskbuild-a-react-dashboard-with-auth-modelanthropicclaude-opus-46.txt

## Parameters

| Param | Required | Description |
|-------|----------|-------------|
| `task` | Yes | Task description or category: `coding`, `reasoning`, `creative`, `vision`, `research`, `fast-cheap`, `general` |
| `budget` | No | `low` ($0-1/M), `medium` ($0-5/M, default), `high` ($2-20/M), `any` |
| `exclude` | No | Comma-separated model IDs to skip |
| `context` | No | Tags like `vision,long-context` for routing boost |

## Get Multiple Recommendations

GET https://ss.deeflect.com/api/recommend?task=coding&budget=low&count=3

get-httpsssdeeflectcomapirecommendtaskcodingbudgetlowcount3.txt

Returns diverse models from different providers. Use for collective/parallel spawning.

## Compare Models

GET https://ss.deeflect.com/api/compare?models=anthropic/claude-opus-4.6,openai/gpt-5.2

get-httpsssdeeflectcomapicomparemodelsanthropicclaude-opus-46openaigpt-52.txt

Side-by-side scores, pricing, capabilities.

## Browse All Models

GET https://ss.deeflect.com/api/models?category=coding&sort=score&limit=10

get-httpsssdeeflectcomapimodelscategorycodingsortscorelimit10.txt

Sort by `score`, `cost`, `efficiency`, or any category name.

## Decompose Complex Tasks

{"task": "Build and deploy a SaaS app", "budget": "medium"}

task-build-and-deploy-a-saas-app-budget-medium.txt

Returns sequential steps with optimal model per step.

## Swarm (Parallel DAG)

{"task": "Research competitors and build pitch deck", "budget": "low"}

task-research-competitors-and-build-pitch-deck-budget-low.txt

Returns a dependency graph of parallel tasks with models assigned.

## Usage Pattern

For any task that needs a sub-agent:

1. **Decide budget** — `low` for cheap/fast, `medium` for quality, `high` for best available
2. **Call /api/pick** with the task description
3. **Use the returned `id`** as the `model` parameter in `sessions_spawn`
4. **If task is complex** — use `/api/decompose` or `/api/swarm` to break it into subtasks, spawn each with its recommended model

## Error Handling

- API down → skip model selection, use `sessions_spawn` without a model (falls back to default)
- No model found (404) → widen budget to `any` and retry
- Rate limited (429) → wait and retry, or fall back to default

## API Status

example.json

{
  "data": {
    "id": "anthropic/claude-opus-4.6",
    "name": "Claude Opus 4.6",
    "score": 86,
    "pricing": { "prompt": 5, "completion": 25 },
    "reason": "Best general model at medium budget ($0-5/M) — score: 86"
  }
}