🇺🇸English
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
1. GET ss.deeflect.com/api/pick?task=<description>&budget=<tier>
2. Use the returned model ID in sessions_spawn
Pick Best Model
GET https://ss.deeflect.com/api/pick?task=build+a+react+dashboard&budget=medium
Response:
{
"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:
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), ($0-5/M, default), ($2-20/M), |
Get Multiple Recommendations
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
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
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
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)
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.
Role Composition (No Plugin)
If you are not using the plugin, you can still get modular role/system-style prompting from the API.
- Discover available block IDs:
GET https://ss.deeflect.com/api/roles/blocks
- Compose a role-enriched prompt:
POST https://ss.deeflect.com/api/roles/compose
{
"task": "Build a SaaS onboarding flow",
"persona": "fullstack-engineer",
"stack": ["nextjs", "typescript", "postgres"],
"domain": "saas",
"format": "full-implementation",
"guardrails": ["code", "security", "production"]
}
3. Use returned fullPrompt as the task for sessions_spawn.
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
GET https://ss.deeflect.com/api/status
Shows model count, data freshness, source health. Data refreshes every 6 hours from 5 benchmark sources.
Weekly Installs
1
Repository
deeflect/smart-spawn
GitHub Stars
1
First Seen
1 day ago
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
amp1
cline1
openclaw1
opencode1
cursor1
kimi-cli1
