Skip to main content
The Swarms API is a comprehensive platform for building and orchestrating AI agents and multi-agent systems. It enables developers to create individual intelligent agents or coordinate thousands of agents in complex workflows, allowing them to communicate, collaborate, and solve problems together.Key Benefits:
  • Agent Orchestration: Create and manage AI agents that can work independently or collaborate
  • Multi-Agent Communication: Enable agents to communicate and share information seamlessly
  • Flexible Workflows: Support for sequential, concurrent, hierarchical, and other workflow patterns
  • Enterprise Scale: A single swarm supports up to 2,000 agents (SwarmSpec.agents)
  • Multi-Model Support: Integration with OpenAI, Anthropic, and Groq models
The Swarms API is designed for developers who need more than just a simple AI completion endpoint. Here’s why you should choose Swarms:
  • Complete Agent Ecosystem: Full ecosystem for building, deploying, and scaling intelligent AI systems
  • Advanced Multi-Agent Architectures: Build complex hierarchical, sequential, and parallel agent collaboration systems
  • Agent-to-Agent Communication: Advanced communication protocols enable seamless agent interaction
  • Ultra-Optimized Runtime: High-performance runtime with built-in optimization for concurrent operations
  • Enterprise-Ready: Built-in security, governance, and compliance features
Agent orchestration in the Swarms API allows you to:
  • Create Individual Agents: Deploy single agents for specific tasks
  • Coordinate Multiple Agents: Build swarms where agents work together
  • Define Workflow Patterns: Choose from sequential, concurrent, hierarchical, and other patterns
  • Enable Communication: Agents can share information and collaborate
  • Scale Dynamically: Add or remove agents based on workload
Example Use Cases:
  • Research teams with multiple agents researching different aspects
  • Medical analysis with lab analyzer and clinical specialist working together
  • Financial analysis with market analyst and economic forecaster collaborating
  • Content creation with writer, editor, and fact-checker in sequence
The swarm_type field on POST /v1/swarm/completions accepts 14 architectures:For each type’s full description, category, and tuning parameters, call GET /v1/swarms/available.
The Swarms API accepts model ids from multiple providers (OpenAI, Anthropic, Google, xAI, Groq, and others) via the model_name field on AgentSpec. If model_name is omitted, the agent uses the default model, claude-sonnet-5.Premium-only models (rejected on the free tier, with a suggested free-tier alternative in the error response):
  • gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.6
  • claude-fable-5, claude-fable-5-1, claude-opus-5, claude-opus-5-5, claude-opus-4-8
  • gemini-3.1-pro-preview, gemini-3.1-pro-preview-customtools
  • xai/grok-4.5, xai/grok-4.5-latest
  • The same models on OpenRouter, e.g. openrouter/openai/gpt-5.6-sol or openrouter/anthropic/claude-opus-4.8 (full list on the Pricing page)
  • Any model id beginning with groq/
The check also matches these ids behind another provider prefix or with a :variant suffix.Free-tier alternatives the API suggests in place of these: claude-sonnet-5, gpt-5.5, gemini-3.5-flash (and claude-haiku-4-5, gpt-5.4-mini, gemini-3.5-flash-lite for the luna tier). Every other model id, including gpt-4.1, is available on the free tier.For the complete, up-to-date list of models your key can use, call GET /v1/models (or GET /v1/models/available for each model’s name and price per 1M tokens). Both leave premium-only models out of a free-tier key’s list.
The Swarms API uses a transparent, usage-based pricing model with per-model token pricing:Per-Model Token Pricing:
  • Input and output tokens are billed at each model’s own price per 1M tokens, plus a 15% service fee.
  • Prices come from OpenRouter for openrouter/... models and from LiteLLM’s price data for every other model. A model with no price data is billed at fallback rates of $6.50 per 1M input and $18.50 per 1M output tokens before the fee.
  • OpenRouter free models (openrouter/... ids ending in :free, and openrouter/openrouter/free) cost $0 per token.
  • Call GET /v1/models/available or GET /v1/models/pricing?model_name=... for current prices, service fee included. For example, at the time of writing gpt-5.4 costs $2.875 per 1M input and $17.25 per 1M output tokens.
MCP servers and the web_scraper tool have no fee of their own; only the tokens are billed.Pricing applies to:
  • Swarm Completions (with agent cost)
  • Agent Completions and Chat Completions
  • Graph Workflow (with agent cost)
  • Batched Grid Workflow (with agent cost)
  • Reasoning Agents
  • Auto Agent Builder ($0.01 per request)
  • Decision Models (each decision model’s own price, from GET /v1/decision/models)
Special Features:
  • Night Time Discount: 50% off token costs for Swarm Completions during 8 PM - 6 AM Pacific Time, for paid members (Pro, Ultra or Premium, or an active subscription). Free accounts pay the full token price at any hour.
For detailed pricing information, examples, and cost calculation formulas, see the Pricing page.
Rate limits are tier-based to ensure fair usage:The batch size limit of 50 applies to all tiers.Premium Tier Benefits:
  • 20x more requests per minute (2,000 vs 100)
  • 28x more requests per hour (10,000 vs 350)
  • 83x more requests per day (100,000 vs 1,200)
  • 10x more tokens per agent (2M vs 200K)
Exactly five endpoints require a Pro, Ultra, or Premium subscription:Call GET /v1/account/premium-endpoints to fetch this list live, along with an upgrade link. All billable endpoints (the five above plus /v1/agent/completions, /v1/swarm/completions, /v1/chat/completions, /v1/responses, /v1/messages and /v1/auto-agent-builder/completions) additionally require a purchased credit balance above $1.00. At or below $1.00 they return 402 insufficient_credits; free and referral credits don’t count.
1. Get Your API Key Visit Swarms Platform to get your free API key.2. Install Client Libraries
3. Make Your First API Call
Built-in Tools:
  • Search Capabilities: Web search integration for research tasks
  • MCP Integration: Model Context Protocol for enhanced interactions
  • Custom Tools: Define your own function tools for specific needs
MCP (Model Context Protocol) Integration:
  • Connect to external data sources
  • Integrate with databases and APIs
  • Enable real-time data access for agents
Custom Tool Development: Create specialized tools using OpenAPI-style function specifications for enhanced agent capabilities.
Common Issues and Solutions:Authentication Errors:
  • Verify your API key is correct and active
  • Check that the x-api-key header is properly set (the Authorization: Bearer <key> header is also accepted)
  • Ensure your API key has the necessary permissions
Rate Limit Exceeded:
  • Implement exponential backoff for failed requests
  • Monitor your API usage to stay within limits
  • Consider upgrading to Premium for higher limits
Timeout Issues:
  • Increase request timeout values
  • Consider breaking complex tasks into smaller chunks
  • Use batch processing for multiple operations
Model Availability:
  • Check if your requested model is currently available
  • Have fallback models configured
  • Check GET /v1/models/available for the models your key can use (GET /health only reports {"status": "ok"})
Enterprise Security:
  • API Key Authentication: Secure authentication for all requests
  • Rate Limiting: Prevents abuse and ensures fair usage
  • Data Encryption: All data is encrypted in transit and at rest
  • Access Controls: Granular permissions and access management
Best Practices:
  • Never commit API keys to version control
  • Use environment variables for all sensitive configuration
  • Implement proper access controls in production environments
  • Regularly rotate API keys
Community Resources:Professional Support:Stay Updated:
Yes! The Swarms API is designed for production use with:
  • Scalability: Handle thousands of concurrent agents
  • Enterprise Features: Security, compliance, and governance
  • Monitoring: Comprehensive logging and analytics
  • Support: Professional support for production deployments
Production Best Practices:
  • Implement proper error handling and retry logic
  • Monitor API usage and costs
  • Use appropriate rate limiting strategies
  • Test thoroughly before deployment
  • Keep API keys secure and rotate regularly
Single Agents:
  • Purpose: Focused tasks that don’t require collaboration
  • Use Cases: Simple Q&A, content generation, data analysis
  • Benefits: Fast, simple, cost-effective
  • Limitations: Limited to single perspective, no collaboration
Multi-Agent Swarms:
  • Purpose: Complex tasks requiring multiple perspectives or specialized skills
  • Use Cases: Research teams, medical analysis, financial forecasting
  • Benefits: Multiple perspectives, specialized expertise, parallel processing
  • Complexity: Higher setup and coordination requirements
Model Selection Guidelines:For Complex Analysis:
  • Use gpt-5.4 or claude-sonnet-5 for tasks requiring deep reasoning
  • Higher token limits for comprehensive analysis
For Fast Responses:
  • Choose gpt-4.1-mini for quick, straightforward tasks
  • Lower costs for high-volume applications
For Creative Tasks:
  • Higher temperature settings (0.7-0.9) work better
  • GPT-4 or Claude models for creative content
For Factual Tasks:
  • Lower temperature settings (0.1-0.3) provide more consistent responses
  • Any model can work well with proper prompting
Yes! The Swarms API is designed for easy integration:Integration Options:
  • REST API: Standard HTTP endpoints for any language
  • Client Libraries: Official SDKs for Python, TypeScript, Go, Java
  • Webhooks: Real-time notifications for long-running tasks
  • Batch Processing: Process multiple requests efficiently
Common Integration Patterns:
  • Microservices: Deploy as independent services
  • API Gateway: Integrate with existing API infrastructure
  • Event-Driven: Trigger agents based on system events
  • Scheduled Tasks: Run agents on regular schedules

Still Have Questions?

If you don’t see your question answered here, we’re here to help: Built with dedication by The Swarm Corporation