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

# Neosantara

> Use Neosantara models in Agno agents.

Neosantara is an LLM Gateway from Indonesia that provides a unified interface to access multiple AI models. See their library of models [here](https://app.neosantara.xyz/models) and explore their documentation [here](https://docs.neosantara.xyz/en/quickstart).

## Authentication

Set your `NEOSANTARA_API_KEY` environment variable. Get your key [from Neosantara here](https://app.neosantara.xyz/api-keys).

```bash Mac theme={null}
export NEOSANTARA_API_KEY=***
```

```bash Windows theme={null}
setx NEOSANTARA_API_KEY ***
```

## Example

Install the `openai` package:

```shell theme={null}
uv pip install -U agno openai
```

Use `Neosantara` with your `Agent`:

```python agent.py theme={null}
from agno.agent import Agent
from agno.models.neosantara import Neosantara

agent = Agent(
    model=Neosantara(id="grok-4.1-fast-non-reasoning"),
    markdown=True,
)

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

> [!NOTE]
>
> View more examples [here](https://agno-v2.mintlify.site/models/providers/gateways/neosantara/usage/basic.md).

## Params

| Parameter | Type | Default | Description |
| - | - | - | - |
| `id` | `str` | `"grok-4.1-fast-non-reasoning"` | The ID of the Neosantara model to use |
| `name` | `str` | `"Neosantara"` | The name of this chat model instance |
| `provider` | `str` | `"Neosantara"` | The provider of the model |
| `api_key` | `Optional[str]` | `None` | The API key for Neosantara (defaults to NEOSANTARA\_API\_KEY env var) |
| `base_url` | `str` | `"https://api.neosantara.xyz/v1"` | The base URL for the Neosantara API |

`Neosantara` also supports the params of [OpenAI](https://agno-v2.mintlify.site/reference/models/openai.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.