Set Up AI Agents on Modellix

If you are an AI agent, this document provides the essential context and tools you need to interact with Modellix.

Modellix is a MaaS platform. One Modellix API key covers Media Models and LLMs. Web Search and Web Fetch are optional Tools. Pick the host that matches the job—do not send media generation to the LLM gateway, and do not poll LLM or Tools responses.

Job	Host	Call style
Image, video, or speech generation	`https://api.modellix.ai`	Async: submit a task, then poll
Chat, coding, or text generation	`https://llm.modellix.ai`	Sync (optional SSE)
Public web results or page content	`https://tool.modellix.ai`	Sync

Human-oriented product map: Platform Overview.

Prerequisite: Create an API Key

A human must create a Modellix account and generate an API key. Create one in the console. With that key, your agent can call Media Models, LLM, and Web Tools.

The API key is displayed only once after creation. Store it securely, typically as MODELLIX_API_KEY.

Agent Skills

The official Modellix Skill teaches coding agents how to discover media models, inspect request schemas, and generate images, videos, and speech. It does not replace the LLM Overview for chat gateway setup. Install via skills.sh:

npx skills add https://github.com/Modellix/modellix-plugin --skill modellix

Target one agent:

npx skills add https://github.com/Modellix/modellix-plugin --skill modellix --agent cursor

Agent Skill

Installation for Cursor, Claude Code, GitHub Copilot, Codex, and other Agent Skills hosts.

Modellix CLI

modellix-cli creates media generation tasks and fetches results from the terminal. Use it for async image, video, and speech workflows—not for LLM chat.

# Install the CLI
npm install -g modellix-cli

# Export the API key
export MODELLIX_API_KEY="your_api_key"

# Create a generation task
modellix-cli model run \
  --model-slug alibaba/qwen-image-edit \
  --body '{"prompt":"A cute cat playing in a garden on a sunny day"}'

# Fetch the task result using the returned task_id
modellix-cli task get task-abc123

Modellix CLI

Authentication, model run --wait, schemas, and task downloads.

Media Models: Async Two-Step

Media generation uses https://api.modellix.ai. Copy the prompt below for your agent, or open it in Cursor.

Agent quick start for async media generation.

Open in Cursor

Full media workflow: REST API.

LLM: Synchronous Chat

The LLM gateway at https://llm.modellix.ai returns text in one response (optional SSE). Pass model as a provider/name ID. Do not poll and do not mix Chat Completions fields with Messages fields.

Client type	Base URL	Protocol
OpenAI SDK, Codex, Cursor, OpenCode (OpenAI mode)	`https://llm.modellix.ai/v1`	Chat Completions or Responses
Anthropic SDK, Claude Code	`https://llm.modellix.ai` (no `/v1`)	Messages

Agent quick start for the Modellix LLM gateway.

Open in Cursor

LLM Overview

Protocols, SDK overrides, coding tools, and token billing.

Web Tools

Web Search and Web Fetch at https://tool.modellix.ai are optional. Use them when the user needs live public web results or readable page content. Calls are synchronous. REST requires X-Mdlx-User-Id. MCP clients can connect to https://tool.modellix.ai/mcp.

Tools Overview

Web Search, Web Fetch, headers, and per-request pricing.

Web Tools MCP

Streamable HTTP MCP for Cursor, Claude Code, Codex, and other clients.

Getting Started

Ways to Use

Team

Set Up AI Agents on Modellix

Prerequisite: Create an API Key

Agent Skills

Agent Skill

Modellix CLI

Modellix CLI

Media Models: Async Two-Step

LLM: Synchronous Chat

LLM Overview

Web Tools

Tools Overview

Web Tools MCP

​Prerequisite: Create an API Key

​Agent Skills

Agent Skill

​Modellix CLI

Modellix CLI

​Media Models: Async Two-Step

​LLM: Synchronous Chat

LLM Overview

​Web Tools

Tools Overview

Web Tools MCP

Prerequisite: Create an API Key

Agent Skills

Modellix CLI

Media Models: Async Two-Step

LLM: Synchronous Chat

Web Tools