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 agnoAuthentication
- Create an account at the Inception Platform.
- Open the dashboard and go to API Keys.
- Create a key and set your
INCEPTION_API_KEYenvironment 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.")Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
id | str | "mercury-2" | The id of the Mercury model to use |
name | str | "Inception" | The name of the model |
provider | str | "InceptionLabs" | The provider of the model |
api_key | Optional[str] | None | The API key for Inception (defaults to INCEPTION_API_KEY env var) |
base_url | str | "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.