Aimlapi Image Agent

Use the current gateway adaptation to analyze an image URL through AIMLAPI.

These retained examples come from the source revision linked below. Use the installation and model configuration in the AI/ML API guide, or use the compatible OpenAILike adaptation below with an older package.

Current main uses gpt-5.6-luna in this cookbook. The retained source below records the earlier model; select an available provider model using the setup instructions.

image_agent.py
"""
Aimlapi Image Agent
===================

Cookbook example for `aimlapi/image_agent.py`.
"""

from agno.agent import Agent
from agno.media import Image
from agno.models.aimlapi import AIMLAPI

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------

agent = Agent(
    model=AIMLAPI(id="meta-llama/Llama-3.2-11B-Vision-Instruct-Turbo"),
    markdown=True,
)

agent.print_response(
    "Tell me about this image",
    images=[
        Image(
            url="https://upload.wikimedia.org/wikipedia/commons/0/0c/GoldenGateBridge-001.jpg"
        )
    ],
    stream=True,
)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    pass

Run the Example

Set up your virtual environment

uv venv --python 3.12
source .venv/bin/activate

Install dependencies

uv pip install -U agno openai

Export your AI/ML API key

export AIMLAPI_API_KEY="your_aimlapi_api_key_here"

Use the working gateway adapter

In the saved Python file, replace the AIMLAPI import with:

from os import environ
from agno.models.openai.like import OpenAILike

Replace the entire AIMLAPI(...) model expression with:

OpenAILike(
    id="openai/gpt-5-2",
    api_key=environ["AIMLAPI_API_KEY"],
    base_url="https://api.aimlapi.com/v1",
)

Keep the surrounding Agent(...) settings and run calls. This route supports image input as well as text; use the provider's exact IDs when choosing another model.

Run the example

Save the code above as image_agent.py, then run:

python image_agent.py

Full source: cookbook/90_models/aimlapi/image_agent.py