> ## Documentation Index > Fetch the complete documentation index at: https://docs.swarms.ai/llms.txt > Use this file to discover all available pages before exploring further. # Pricing > This page details the pricing structure and how credits are deducted for various API operations. 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 | Rate limits | Support | Best for | Key features | | - | -: | - | -: | - | - | - | - | - | | Free | \$0 | N/A | \$0/year | No | 100/min, 350/hr, 1,200/day | Community | Getting started | Basic API, pay‑per‑use, community support, Marketplace access | | Pro | \$19.99 | 15% | \$203.90/year | Yes | 2,000/min, 10,000/hr, 100,000/day | Priority | Professionals | Premium models, Premium Endpoints access | | Ultra | \$100 | 15% | \$1,020/year | Yes | 2,000/min, 10,000/hr, 100,000/day | Priority | Teams & production | Everything in Pro, higher token-per-agent limit, full Premium Endpoints | Prices shown are subscription fees; API usage is billed per operation (see Usage-based pricing below). Rate limits shown are those returned by `GET /v1/rate/limits` for any account with an active premium subscription (`pro`, `ultra`, or `premium` tier) — see [Rate Limits](/docs/documentation/resources/ratelimits) for how free vs. premium tiers are resolved. Some plan-comparison items you may see elsewhere (e.g. SOC 2 certification, dedicated infrastructure, or request-priority routing) are account/infrastructure-level facts that could not be verified against the Swarms API application source and are intentionally omitted from this table. See [Security](/docs/documentation/resources/security) and [Priority Processing](/docs/documentation/resources/priority-processing) for what is verifiable. ### Update your plan in 3 steps 1. Go to the Account Dashboard. 2. Open the Billing tab and scroll down to the Plans section. 3. 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) * Higher rate limits: 2,000 req/min, 10,000 req/hour, 100,000 req/day, 2M tokens per agent (vs. free tier's 100/350/1,200 and 200K — see [Rate Limits](/docs/documentation/resources/ratelimits)) * Access to premium-only models (see below) * **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. Note: per `api/schemas.py` (`RateLimitsPremiumTier`), Pro and Ultra currently resolve to the same numeric rate limits and per-agent token limit — any account with an active subscription (`pro`, `ultra`, or `premium` tier) gets the same premium allowances. * Full access to Premium Endpoints * For compliance certifications and enhanced-security specifics, see [Security](/docs/documentation/resources/security) ### 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.6-sol` * `gpt-5.6-terra` * `gpt-5.6-luna` * `gpt-5.6` * `claude-fable-5` * `claude-opus-5` * `claude-opus-4-8` * `gemini-3.1-pro` * `gemini-3.1-deep-think` * `xai/grok-4.5` * `xai/grok-4.5-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 (\$0.01/agent); night-time discount applies to tokens | | Agent Completions | No per-agent fee | | Graph Workflow | Agent cost applies (\$0.01/agent), billed at agent-completion token rates; no night-time discount | | Batched Grid Workflow | Agent cost applies (\$0.01/agent), billed at agent-completion token rates; no night-time discount | | Auto Agent Builder | Agent cost applies (\$0.01/agent), billed at agent-completion token rates; no night-time discount | ### 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: ```bash theme={null} GET /v1/usage/costs ``` **Example Response:** ```json theme={null} { "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" } ``` ### Checking Your Credit Balance Use `GET /v1/account/credits` to check your current balance before making billable requests: ```bash theme={null} curl -H "x-api-key: $SWARMS_API_KEY" \ https://api.swarms.world/v1/account/credits ``` ```json theme={null} { "credit": 12.50, "free_credit": 3.00, "referral_credits": 20.00, "total_credits": 35.50 } ``` `total_credits` is the sum of `credit`, `free_credit`, and `referral_credits` — this is the number checked against the \$1.00 minimum for billable routes. ### 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 | Deducted in this order: `free_credit` first, then `referral_credits`, then regular `credit`. | | Token Counting | Token counts are calculated using model-specific tokenizers. | | Pricing Updates | Pricing may be updated periodically. Check `/v1/usage/costs` for current pricing. | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.