Meta Model API

Start here

Overview
Quickstart
Authentication
Models
SDKs and libraries
Pricing and rate limits

Capabilities

Tool calling
Tool search
Search grounding
Image understanding
Video understanding
File handling
Reasoning
Structured output
Prompt caching
Token counting

Protocols

Choosing an API
Responses API
Chat Completions API
Messages API

Cookbook

All recipes
API fundamentals
Agent patterns
Use cases
Building with Muse Code

Muse Code

Overview
Authentication and billing
Permissions and safety
Working with the agent
Configuration and context
Extending and automating

Muse Glimmer

Overview
Get the model
Prompting guide
Quantization
Speculative decoding
Run inference
Customization

Agent guides

Coding agents
Agent frameworks
Computer use

API reference

Introduction
Error handling
Status
Responses
Chat completions
Messages
Files
Models

Log in

--- meta: title: Pricing and rate limits description: Standard and contributor pricing tiers, per-token pricing, and rate limits for Meta Model API. keywords: pricing, standard tier, contributor tier, discounted pricing, training, pay-as-you-go, per-token pricing, cost, rate limits, requests per minute, tokens per minute, throttling, background cms: alias: /model-api/docs/pricing-rate-limits target: aidmc --- # Pricing and rate limits ## Pricing {#pricing} You pay only for what you use. Meta Model API bills per token with no minimums or upfront commitment, priced per 1M tokens in USD. Your rate depends on the model's **tier**. ### Standard tier {#standard-tier} Models: `muse-spark-1.1`, `muse-spark-1.2`. Standard pricing; your prompts and completions are not used to train Meta models. Both checkpoints share the same standard pricing: | Usage | Price per 1M tokens | | :---- | :---- | | Cached input | $0.15 | | Input | $1.25 | | Output | $4.25 | ### Contributor tier {#contributor-tier} Model: `muse-spark-1.2-contributor`. Heavily discounted token pricing in exchange for permission to use your prompts and completions to train future Meta models. It lowers the barrier to entry for prototyping, testing integrations, and scaling experiments where training on your data is acceptable. | Usage | Price per 1M tokens | | :---- | :---- | | Cached input | $0.002 | | Input | $0.10 | | Output | $0.20 | ### Shared pricing notes Cached input costs less. When part of your prompt matches a [cached prefix](/docs/prompt-caching), you pay the cached-input rate for those tokens. Check `cached_tokens` in the response to see how many were served from cache. **Web search grounding** costs **$2.50 per 1,000 search queries**, in addition to tokens for the request. See [Search grounding](/docs/search-grounding). There is **no long-context premium**: you pay the same rate whether your context window is mostly empty or almost full. ## Rate limits {#rate-limits} Rate limits control per-minute usage for your team and are set by pricing tier. The Standard tier covers `muse-spark-1.1` and `muse-spark-1.2`; the Contributor tier covers `muse-spark-1.2-contributor`. | Tier | Requests per minute (RPM) | Tokens per minute (TPM) | | :---- | :---- | :---- | | Standard | 3,000 | 4,000,000 | | Contributor | 100 | 3,000,000 | Limits apply **per team, not per API key**. If you use multiple keys in one team, all requests and tokens count toward one shared quota. Token usage counts only **your** input and output tokens. Meta injects a small amount of steering context into every prompt (a system prompt and related scaffolding); those injected tokens are not billed and are excluded from the token counts reported in your `usage` and by the [token-counting endpoints](/docs/token-counting#injected-tokens). ## Retry on 429 responses {#rate-limit-behavior} If you exceed RPM or TPM, the API returns `HTTP 429 Too Many Requests`. Requests succeed again once usage drops below the limit. **Retry strategy:** Use exponential backoff with jitter. Start with a short delay such as 500 ms, double it after each consecutive `429`, and add random jitter to avoid thundering-herd effects across concurrent clients. ## Read rate-limit headers {#rate-limit-headers} Every successful response includes headers that report your current limit and remaining quota: | Header | Description | | :---- | :---- | | `x-ratelimit-limit-tokens` | Total token budget for the current window. | | `x-ratelimit-remaining-tokens` | Tokens remaining before you hit the limit. | | `x-ratelimit-limit-requests` | Total request budget for the current window. | | `x-ratelimit-remaining-requests` | Requests remaining before you hit the limit. | Read these headers and slow down before you hit a `429` instead of reacting after one. ## Submit background responses within limits {#background-rate-limit} Creating [background responses](/docs/protocols/responses#using-with-other-features) (`background: true`) counts against a separate per-team submission limit in addition to the RPM and TPM limits above. The default is **600 background submissions per minute, per team**. If you exceed that cap, new background submissions return `HTTP 429 Too Many Requests` with a `Retry-After` header. Responses already running continue unaffected. Apply the same exponential-backoff-with-jitter strategy described above. The cap applies only to starting new background responses. Standard RPM and TPM limits still apply to every request. ## Next steps - [Authentication](/docs/authentication): create and manage API keys - [Get started](/docs/quickstart#first-call): make your first API call - [Chat completion](/docs/protocols/chat-completions): start generating text with the core conversational endpoint

Pricing and rate limits

Pricing

You pay only for what you use. Meta Model API bills per token with no minimums or upfront commitment, priced per 1M tokens in USD. Your rate depends on the model's tier.

Standard tier

Models: muse-spark-1.1, muse-spark-1.2. Standard pricing; your prompts and completions are not used to train Meta models. Both checkpoints share the same standard pricing:
Usage
Price per 1M tokens
Cached input
$0.15
Input
$1.25
Output
$4.25

Contributor tier

Model: muse-spark-1.2-contributor. Heavily discounted token pricing in exchange for permission to use your prompts and completions to train future Meta models. It lowers the barrier to entry for prototyping, testing integrations, and scaling experiments where training on your data is acceptable.
Usage
Price per 1M tokens
Cached input
$0.002
Input
$0.10
Output
$0.20

Shared pricing notes

Cached input costs less. When part of your prompt matches a cached prefix, you pay the cached-input rate for those tokens. Check cached_tokens in the response to see how many were served from cache.Web search grounding costs $2.50 per 1,000 search queries, in addition to tokens for the request. See Search grounding.There is no long-context premium: you pay the same rate whether your context window is mostly empty or almost full.

Rate limits

Rate limits control per-minute usage for your team and are set by pricing tier. The Standard tier covers muse-spark-1.1 and muse-spark-1.2; the Contributor tier covers muse-spark-1.2-contributor.
Tier
Requests per minute (RPM)
Tokens per minute (TPM)
Standard
3,000
4,000,000
Contributor
100
3,000,000
Limits apply per team, not per API key. If you use multiple keys in one team, all requests and tokens count toward one shared quota.Token usage counts only your input and output tokens. Meta injects a small amount of steering context into every prompt (a system prompt and related scaffolding); those injected tokens are not billed and are excluded from the token counts reported in your usage and by the token-counting endpoints.

Retry on 429 responses

If you exceed RPM or TPM, the API returns HTTP 429 Too Many Requests. Requests succeed again once usage drops below the limit.Retry strategy: Use exponential backoff with jitter. Start with a short delay such as 500 ms, double it after each consecutive 429, and add random jitter to avoid thundering-herd effects across concurrent clients.

Read rate-limit headers

Every successful response includes headers that report your current limit and remaining quota:
Header
Description
x-ratelimit-limit-tokens
Total token budget for the current window.
x-ratelimit-remaining-tokens
Tokens remaining before you hit the limit.
x-ratelimit-limit-requests
Total request budget for the current window.
x-ratelimit-remaining-requests
Requests remaining before you hit the limit.
Read these headers and slow down before you hit a 429 instead of reacting after one.

Submit background responses within limits

Creating background responses (background: true) counts against a separate per-team submission limit in addition to the RPM and TPM limits above. The default is 600 background submissions per minute, per team.If you exceed that cap, new background submissions return HTTP 429 Too Many Requests with a Retry-After header. Responses already running continue unaffected. Apply the same exponential-backoff-with-jitter strategy described above.The cap applies only to starting new background responses. Standard RPM and TPM limits still apply to every request.

Next steps

  • •Authentication: create and manage API keys
  • •Get started: make your first API call
  • •Chat completion: start generating text with the core conversational endpoint
Was this page helpful?
Pricing
Rate limits
Retry on 429 responses
Read rate-limit headers
Submit background responses within limits
Next steps