> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-agui.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Together

> Use Together AI models with Agno agents.

Together is a platform for providing endpoints for Large Language models.
See their library of models [here](https://www.together.ai/models).

We recommend experimenting to find the best-suited model for your use-case.

Together have tier based rate limits. See the [docs](https://docs.together.ai/docs/rate-limits) for more information.

## Authentication

Set your `TOGETHER_API_KEY` environment variable. Get your key [from Together here](https://api.together.xyz/settings/api-keys).

<CodeGroup>
  ```bash Mac theme={null}
  export TOGETHER_API_KEY=***
  ```

  ```bash Windows theme={null}
  setx TOGETHER_API_KEY ***
  ```
</CodeGroup>

## Example

Use `Together` with your `Agent`:

<CodeGroup>
  ```python agent.py theme={null}
  from agno.agent import Agent
  from agno.models.together import Together

  agent = Agent(
      model=Together(id="meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo"),
      markdown=True
  )

  # Print the response in the terminal
  agent.print_response("Share a 2 sentence horror story.")
  ```
</CodeGroup>

<Note> View more examples [here](/models/providers/gateways/together/usage/basic-stream). </Note>

## Params

| Parameter  | Type            | Default                                         | Description                                                       |
| ---------- | --------------- | ----------------------------------------------- | ----------------------------------------------------------------- |
| `id`       | `str`           | `"meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo"` | The id of the Together model to use                               |
| `name`     | `str`           | `"Together"`                                    | The name of the model                                             |
| `provider` | `str`           | `"Together"`                                    | The provider of the model                                         |
| `api_key`  | `Optional[str]` | `None`                                          | The API key for Together (defaults to TOGETHER\_API\_KEY env var) |
| `base_url` | `str`           | `"https://api.together.xyz/v1"`                 | The base URL for the Together API                                 |

`Together` also supports the params of [OpenAI](/reference/models/openai).