Use Modellix LLM with Agno

Use Agno against the Modellix LLM gateway. Agno provides OpenAILike for any OpenAI-compatible Chat Completions endpoint — set base_url to https://llm.modellix.ai/v1 and id to a Modellix provider/name Model ID.

This page covers LLM text only (https://llm.modellix.ai).Modellix model IDs are provider/name (for example openai/gpt-5.5). Pass that full string as OpenAILike(id=...). Do not rely on a bare string like model="openai:gpt-5.4" — that uses Agno’s built-in OpenAI provider defaults, not Modellix. See Models & Pricing.

Set Up Agno

Install Agno

pip install "agno[openai]"

Or with uv:

uv pip install "agno[openai]"

Set Credentials

Create a Modellix API key in the console:

export MODELLIX_API_KEY="mdlx-xxxxxxxx"

Setting	Value
`api_key` / `MODELLIX_API_KEY`	Modellix API Key
`base_url`	`https://llm.modellix.ai/v1` (include `/v1`)
`id`	Exact Modellix Model ID (`provider/name`)

Use a Modellix key, not an OpenAI platform key. Do not point Agno at the media host (https://api.modellix.ai).

Create an Agent with OpenAILike

from os import getenv
from agno.agent import Agent
from agno.models.openai.like import OpenAILike

agent = Agent(
    model=OpenAILike(
        id="openai/gpt-5.5",
        api_key=getenv("MODELLIX_API_KEY"),
        base_url="https://llm.modellix.ai/v1",
    ),
    markdown=True,
)

agent.print_response("Introduce yourself in one sentence.", stream=True)

Change id to any catalog Model ID (anthropic/claude-sonnet-5, google/gemini-3.6-flash, and so on). Traffic still uses Chat Completions on https://llm.modellix.ai/v1.

Optional: Retries and Streaming

model = OpenAILike(
    id="openai/gpt-5.5",
    api_key=getenv("MODELLIX_API_KEY"),
    base_url="https://llm.modellix.ai/v1",
    retries=2,
    delay_between_retries=1,
    exponential_backoff=True,
)

agent = Agent(model=model, markdown=True)
agent.print_response("Write a one-line haiku about APIs.", stream=True)

Model-level retries cover transient provider errors (rate limits, server errors). Auth and invalid-request failures are not retried.

Optional: Responses API

Modellix also exposes POST /v1/responses. For OpenAI-compatible Responses / Open Responses style clients, Agno documents OpenResponses with a custom base_url:

from agno.agent import Agent
from agno.models.openai import OpenResponses

agent = Agent(
    model=OpenResponses(
        id="openai/gpt-5.5",
        api_key=getenv("MODELLIX_API_KEY"),
        base_url="https://llm.modellix.ai/v1",
    ),
)

agent.print_response("Say hello in one short sentence.")

Prefer OpenAILike (Chat Completions) first unless you specifically need the Responses path. Class names and imports can vary by Agno version — check the OpenAI-like and Models overview pages for your release.

Troubleshooting

Symptom	Check
Still hitting OpenAI	Use `OpenAILike(..., base_url="https://llm.modellix.ai/v1")`, not `model="openai:..."`
401 Unauthorized	`api_key` / `MODELLIX_API_KEY` is a valid Modellix key
Model not found / 404	`id` is a full ID like `openai/gpt-5.5`, not bare `gpt-5.5`
Wrong path	`base_url` is `https://llm.modellix.ai/v1` (include `/v1`)
Import errors	Install `agno[openai]`; confirm `OpenAILike` import path for your Agno version

Agno models overview — model configuration and retries
OpenAI-compatible models — OpenAILike + custom base_url
OpenAI SDK — same /v1 gateway without Agno
CrewAI — another Python agent framework on Chat Completions
Models & Pricing — Model IDs and rates
LLM API guide — protocols and curl examples

Get Started

API

Agent

SDK

Framework

IDE

Tool

Use Modellix LLM with Agno

Set Up Agno

Troubleshooting

​Set Up Agno

​Troubleshooting

​Related

Set Up Agno

Troubleshooting

Related