Aimlapi Image Agent Bytes

Use the current gateway adaptation to analyze raw image bytes 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.

This retained example was removed from current main. For the maintained image-input recipe, see Image Agent. The source link below preserves its historical implementation.

image_agent_bytes.py
"""
Aimlapi Image Agent Bytes
=========================

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

from pathlib import Path

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,
)

image_path = Path(__file__).parent.joinpath("sample.jpg")

# Read the image file content as bytes
image_bytes = image_path.read_bytes()

agent.print_response(
    "Tell me about this image",
    images=[
        Image(content=image_bytes),
    ],
    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.

Add the image file

Save a JPEG image as sample.jpg beside image_agent_bytes.py before running. The source reads that file without downloading it.

Run the example

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

python image_agent_bytes.py

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