Inception

Use Inception Labs Mercury diffusion models with Agno agents.

Inception builds Mercury, a family of diffusion large language models (dLLMs) that refine all tokens in parallel instead of generating them left-to-right, making them very fast. Inception serves the models through an OpenAI-compatible API, so you drive them through Agno like any other OpenAI-compatible provider.

The Inception class defaults to mercury-2 and points at https://api.inceptionlabs.ai/v1.

Installation

uv pip install -U openai agno

Authentication

  1. Create an account at the Inception Platform.
  2. Open the dashboard and go to API Keys.
  3. Create a key and set your INCEPTION_API_KEY environment variable.
export INCEPTION_API_KEY="YOUR_API_KEY"

Example

Use Inception with your Agent:

from agno.agent import Agent
from agno.models.inception import Inception

agent = Agent(model=Inception(id="mercury-2"), markdown=True)

# Print the response in the terminal
agent.print_response("Share a 2 sentence horror story.")
View more examples here.

Parameters

ParameterTypeDefaultDescription
idstr"mercury-2"The id of the Mercury model to use
namestr"Inception"The name of the model
providerstr"InceptionLabs"The provider of the model
api_keyOptional[str]NoneThe API key for Inception (defaults to INCEPTION_API_KEY env var)
base_urlstr"https://api.inceptionlabs.ai/v1"The base URL for the Inception API

Inception extends the OpenAI-compatible interface and supports most parameters from the OpenAI model.

Mercury 2 supports provider-enforced JSON Schema output. The current Agno adapter defaults supports_native_structured_outputs to False: use use_json_mode=True for JSON output with local validation, or explicitly set Inception(id="mercury-2", supports_native_structured_outputs=True) for the schema request. See the two output modes.

To hit a different host (private deployment, regional endpoint), pass base_url:

Inception(id="mercury-2", base_url="https://your-host.example.com/v1")

Available Models

Use mercury-2 for chat and agent tool calls. Consult the current Inception model catalog for availability. Mercury Edit 2 serves a separate code-editing/FIM API; it is not a drop-in chat model for this adapter.