Swarms API Documentation - Build AI Agents & Multi-Agent Systems

This page details the pricing structure and how credits are deducted for various API operations.

To upgrade your plan, visit the Account Dashboard, open the Billing tab, and select your tier.

API Subscriptions

Flexible subscription plans that scale with your needs. Choose a plan for higher limits and features; usage is billed per operation.

Plans at a glance

Plan	Monthly price	Discount %	Annual price	Premium Endpoints	SOC 2	Priority routing	Support	Best for	Key features
Free	$0	N/A	$0/year	No	No	No	Community	Getting started	Basic API, pay‑per‑use, community support, Marketplace access
Pro	$19.99	15%	$203.90/year	Yes	No	No	Priority	Professionals	Global availability, multi‑agent architectures, accelerated hardware, API telemetry, priority support, Pro models, Premium Endpoints access
Ultra	$100	15%	$1,020/year	Yes	Yes	Yes	Priority	Teams & production	Everything in Pro, premium models, higher limits, SOC 2, enhanced security, priority region/zone routing, full Premium Endpoints

Prices shown are subscription fees; API usage is billed per operation (see Usage-based pricing below).

Update your plan in 3 steps

Go to the Account Dashboard.
Open the Billing tab and scroll down to the Plans section.
Select your desired plan. You’ll be redirected to Stripe to complete payment.

Free

Get started with AI. No monthly fees — pay only for usage.

Sign-up bonus credits
Basic API access
Pay-per-use pricing
Community support
Standard processing speed
Access to the Marketplace
Note: Premium endpoints (batch processing, reasoning agents, advanced workflows) are not available on the free tier

Pro

Most popular. Perfect for professionals who need more power and features.

$19.99/month (save 15% with annual billing)
Global availability
Exclusive multi-agent architectures
Accelerated hardware
API telemetry platform
Priority support
Access to Pro models
Access to Premium Endpoints: Unlock batch processing, reasoning agents, and advanced workflows
- /v1/agent/batch/completions - High-throughput batch agent processing
- /v1/swarm/batch/completions - Batch swarm completions
- /v1/reasoning-agent/completions - Advanced reasoning capabilities
- /v1/batched-grid-workflow/completions - Grid workflow execution
- Plus graph workflows
- See full list: Premium Endpoints

Ultra

Best for growing teams and production workloads that need higher limits and security.

$100/month (save 15% with annual billing)
Everything in Pro, plus:
- Premium models
- More agents per request
- More completions
- Increased rate limits
- SOC 2 compliance
- Enhanced security features
- View previous agent configurations
- Priority region/zone routing
- Full access to Premium Endpoints

Premium-Only Models

Free tier accounts are blocked from requesting the following models on any endpoint (including /v1/agent/completions and /v1/swarm/completions), regardless of available credits. Any active Pro or Ultra subscription unlocks all of them — there is no separate model tier between Pro and Ultra:

gpt-5
gpt-4.1
gemini-2.5-pro
claude-4-opus-20250514
claude-4-sonnet-20250514
claude-haiku-4-5
claude-opus-4-1
claude-sonnet-4-5
xai/grok-4
xai/grok-4-fast-reasoning
xai/grok-4-fast-non-reasoning
xai/grok-4-latest
Any groq/* model

Requesting one of these models on the free tier returns a 403 error with suggested free-tier alternatives.

Enterprise

Critical support, compliance, and control for large-scale enterprises.

Contact sales for custom pricing
Dedicated 24/7 support
Custom solutions engineering
Onsite training and onboarding
Custom agent development
No rate limits
Access to experimental features

Usage-based pricing

Pay only for what you use with transparent, per-operation pricing. All API endpoints use a unified pricing structure for token costs.

Pricing Table

Item	Price	Unit	Notes
Input Tokens	$6.50	per 1M tokens	Unified pricing across all endpoints
Output Tokens	$18.50	per 1M tokens	Unified pricing across all endpoints
Agent Cost	$0.01	per agent	For swarms and workflows
Image Processing	$0.25	per image	Charged when image provided
MCP Call	$0.10	per call	Charged when MCP URL provided
Exa Search Tool	$0.04	per search	Charged per search execution
Web Scraper Tool	$0.15	per scrape	Charged per scrape execution
Night-time Discount	50% off tokens	8 PM - 6 AM PT	Swarm Completions only

Unified Pricing

All API endpoints use the same token pricing:

Input Tokens: $6.50 per 1 million tokens
Output Tokens: $18.50 per 1 million tokens

This applies to:

Endpoint	Notes
Swarm Completions	Agent cost applies
Agent Completions
Graph Workflow	Agent cost applies
Batched Grid Workflow	Agent cost applies

Discounts

Night Time Discount: Swarm completions receive a 50% discount on token costs during 8 PM - 6 AM Pacific Time. Agent costs remain the same.

Retrieving Current Costs

You can retrieve the current pricing using the /v1/usage/costs endpoint:

GET /v1/usage/costs

Example Response:

{
  "usage_pricing": {
    "swarm_completions_agent_cost": 0.01,
    "swarm_completions_input_cost_per_1m": 6.5,
    "swarm_completions_output_cost_per_1m": 18.5,
    "agent_completions_input_cost_per_1m": 6.5,
    "agent_completions_output_cost_per_1m": 18.5,
    "agent_completions_img_cost": 0.25,
    "agent_completions_mcp_cost": 0.1,
    "search_cost": 0.04,
    "scrape_cost": 0.15,
    "night_time_discount": 0.5
  },
  "timestamp": "2026-03-29T18:30:00+00:00"
}

Important Notes

Important Note	Description
Minimum Balance	Billable completion endpoints require a total credit balance above $1.00, checked before the request runs. Requests below this are rejected with a 402 Payment Required error before any work is done.
Credits Deduction	Credits are deducted automatically after each request completes.
Credits Usage Order	Free credits are used first, followed by regular credits.
Token Counting	Token counts are calculated using model-specific tokenizers.
Pricing Updates	Pricing may be updated periodically. Check `/v1/usage/costs` for current pricing.

Getting Started

Clients

Agent Completions

Multi-Agent

Batch

Capabilities

Resources

Swarms Cloud

Pricing

API Subscriptions

Plans at a glance

Update your plan in 3 steps

Free

Pro

Ultra

Premium-Only Models

Enterprise

Usage-based pricing

Pricing Table

Unified Pricing

Discounts

Retrieving Current Costs

Important Notes

​API Subscriptions

​Plans at a glance

​Update your plan in 3 steps

​Free

​Pro

​Ultra

​Premium-Only Models

​Enterprise

​Usage-based pricing

​Pricing Table

​Unified Pricing

​Discounts

​Retrieving Current Costs

​Important Notes

API Subscriptions

Plans at a glance

Update your plan in 3 steps

Free

Pro

Ultra

Premium-Only Models

Enterprise

Usage-based pricing

Pricing Table

Unified Pricing

Discounts

Retrieving Current Costs

Important Notes