# Compound

While LLMs excel at generating text, Groq's Compound systems take the next step. 
Compound is an advanced AI system that is designed to solve problems by taking action and intelligently uses external tools, such as web search and code execution, alongside the powerful [GPT-OSS 120B](/docs/model/openai/gpt-oss-120b), [Llama 4 Scout](/docs/model/meta-llama/llama-4-scout-17b-16e-instruct), and [Llama 3.3 70B](/docs/model/llama-3.3-70b-versatile) models.
This allows it access to real-time information and interaction with external environments, providing more accurate, up-to-date, and capable responses than an LLM alone.

## Available Compound Systems

There are two compound systems available:
 - [`groq/compound`](/docs/compound/systems/compound): supports multiple tool calls per request. This system is great for use cases that require multiple web searches or code executions per request.
 - [`groq/compound-mini`](/docs/compound/systems/compound-mini): supports a single tool call per request. This system is great for use cases that require a single web search or code execution per request. `groq/compound-mini` has an average of 3x lower latency than `groq/compound`.

Both systems support the following tools:

- [Web Search](/docs/web-search)
- [Visit Website](/docs/visit-website)
- [Code Execution](/docs/code-execution)
- [Browser Automation](/docs/browser-automation)
- [Wolfram Alpha](/docs/wolfram-alpha)

<br/>

Custom [user-provided tools](/docs/tool-use) are not supported at this time.

## Quickstart

To use compound systems, change the `model` parameter to either `groq/compound` or `groq/compound-mini`:


And that's it!

<br/>

When the API is called, it will intelligently decide when to use search or code execution to best answer the user's query.
These tool calls are performed on the server side, so no additional setup is required on your part to use built-in tools.

<br/>

In the above example, the API will use its build in web search tool to find the current weather in Tokyo.
If you didn't use compound systems, you might have needed to add your own custom tools to make API requests to a weather service, then perform multiple API calls to Groq to get a final result.
Instead, with compound systems, you can get a final result with a single API call.

## Executed Tools

To view the tools (search or code execution) used automatically by the compound system, check the `executed_tools` field in the response:


## Model Usage Details

The `usage_breakdown` field in responses provides detailed information about all the underlying models used during the compound system's execution. 

```json
"usage_breakdown": {
  "models": [
    {
      "model": "llama-3.3-70b-versatile",
      "usage": {
        "queue_time": 0.017298032,
        "prompt_tokens": 226,
        "prompt_time": 0.023959775,
        "completion_tokens": 16,
        "completion_time": 0.061639794,
        "total_tokens": 242,
        "total_time": 0.085599569
      }
    },
    {
      "model": "openai/gpt-oss-120b",
      "usage": {
        "queue_time": 0.019125835,
        "prompt_tokens": 903,
        "prompt_time": 0.033082052,
        "completion_tokens": 873,
        "completion_time": 1.776467372,
        "total_tokens": 1776,
        "total_time": 1.809549424
      }
    }
  ]
}
```

## System Versioning
Compound systems support versioning through the `Groq-Model-Version` header. In most cases, you won't need to change anything since you'll automatically be on the latest stable version. To view the latest changes to the compound systems, see the [Compound Changelog](/docs/changelog/compound).

### Available Systems and Versions
| System | Default Version<br/>(no header) | Latest Version<br/>(`Groq-Model-Version: latest`) | Previous Versions |
|--------|--------------------------------|---------------------------------------------------|------------------|
| [`groq/compound`](/docs/compound/systems/compound) | `2025-08-16` (stable) | `2025-08-16` (latest) | `2025-07-23` |
| [`groq/compound-mini`](/docs/compound/systems/compound-mini) | `2025-08-16` (stable) | `2025-08-16` (latest) | `2025-07-23` |

### Version Details

- **Default (no header)**: Uses version `2025-08-16`, the most recent stable version that has been fully tested and deployed
- **Latest** (`Groq-Model-Version: latest`): Uses version `2025-08-16`, the prerelease version with the newest features before they're rolled out to everyone

<br />

To use a specific version, pass the version in the `Groq-Model-Version` header:


## What's Next?

Now that you understand the basics of compound systems, explore these topics:

- **[Systems](/docs/compound/systems)** - Learn about the two compound systems and when to use each one
- **[Built-in Tools](/docs/compound/built-in-tools)** - Learn about the built-in tools available in Groq's Compound systems
- **[Search Settings](/docs/web-search#search-settings)** - Customize web search behavior with domain filtering
- **[Use Cases](/docs/compound/use-cases)** - Explore practical applications and detailed examples

---

## Use Cases