# Observability for MiniMax with Opik

MiniMax provides OpenAI-compatible and Anthropic-compatible APIs for its language models. Opik can trace either protocol by wrapping the corresponding Python SDK client.

## Install the dependencies

Install Opik and the SDK for the protocol you plan to use:

```bash
pip install opik openai anthropic
```

Configure Opik for your deployment:

```bash
opik configure
```

Set your MiniMax API key:

```bash
export MINIMAX_API_KEY="<MINIMAX_API_KEY>"
```

## Choose an endpoint

Use the endpoint for your account region and SDK protocol:

| Region | OpenAI-compatible base URL    | Anthropic-compatible base URL        |
| ------ | ----------------------------- | ------------------------------------ |
| Global | `https://api.minimax.io/v1`   | `https://api.minimax.io/anthropic`   |
| China  | `https://api.minimaxi.com/v1` | `https://api.minimaxi.com/anthropic` |

You can find additional API details in the [global MiniMax documentation](https://platform.minimax.io/docs) or the [China MiniMax documentation](https://platform.minimaxi.com/docs).

## Track OpenAI-compatible calls

Wrap the OpenAI client with `track_openai` and pass the MiniMax base URL:

```python
import os

from openai import OpenAI
from opik.integrations.openai import track_openai

client = OpenAI(
    api_key=os.environ["MINIMAX_API_KEY"],
    base_url="https://api.minimax.io/v1",
)
client = track_openai(client, project_name="minimax-demo")

response = client.chat.completions.create(
    model="MiniMax-M3",
    messages=[{"role": "user", "content": "Explain observability in one sentence."}],
)

print(response.choices[0].message.content)
```

For a China account, change `base_url` to `https://api.minimaxi.com/v1`.

## Track Anthropic-compatible calls

Wrap the Anthropic client with `track_anthropic` and pass the MiniMax base URL:

```python
import os

import anthropic
from opik.integrations.anthropic import track_anthropic

client = anthropic.Anthropic(
    api_key=os.environ["MINIMAX_API_KEY"],
    base_url="https://api.minimax.io/anthropic",
)
client = track_anthropic(client, project_name="minimax-demo")

response = client.messages.create(
    model="MiniMax-M3",
    max_tokens=512,
    messages=[{"role": "user", "content": "Explain observability in one sentence."}],
)

print(response.content[0].text)
```

For a China account, change `base_url` to `https://api.minimaxi.com/anthropic`.

## Model identifiers

Use the model identifier exposed by your MiniMax account. Current text model identifiers include:

- `MiniMax-M3`
- `MiniMax-M2.7`

The wrapped clients preserve the normal SDK response objects while Opik records the request, response, token usage, and model metadata.

## Related pages

- [Observability for Anthropic with Opik](./python-anthropic.md)
- [Observability for AWS Bedrock with Opik](./python-bedrock.md)
- [Observability for BytePlus with Opik](./python-byteplus.md)
- [Observability for Cohere with Opik](./python-cohere.md)
- [Observability for DeepSeek with Opik](./python-deepseek.md)
- [Observability for Fireworks AI with Opik](./python-fireworks-ai.md)
- [Observability for Google Gemini (Python) with Opik](./python-gemini.md)
- [Observability for Groq with Opik](./python-groq.md)
- [Observability for TypeSafe AI (Python) with Opik](./python-typesafe.md)
- [Observability for Mistral AI (Python) with Opik](./python-mistral.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.