Dalle

Prerequisites

You need to install the openai library.

uv pip install openai

Set the OPENAI_API_KEY environment variable.

export OPENAI_API_KEY=****

Example

The following agent will use DALL-E to generate an image based on a text prompt.

cookbook/14_tools/dalle_tools.py

from agno.agent import Agent
from agno.tools.dalle import DalleTools

# Create an Agent with the DALL-E tool
agent = Agent(tools=[DalleTools()], name="DALL-E Image Generator")

# Example 1: Generate a basic image with default settings
agent.print_response("Generate an image of a futuristic city with flying cars and tall skyscrapers", markdown=True)

# Example 2: Generate an image with custom settings
custom_dalle = Dalle(model="dall-e-3", size="1792x1024", quality="hd", style="natural")

agent_custom = Agent(
    tools=[custom_dalle],
    name="Custom DALL-E Generator",
    )

agent_custom.print_response("Create a panoramic nature scene showing a peaceful mountain lake at sunset", markdown=True)

Toolkit Params

Parameter	Type	Default	Description
model	str	"dall-e-3"	The DALL-E model to use
enable_create_image	bool	True	Enable the create image functionality
n	int	1	Number of images to generate
size	str	"1024x1024"	Image size (256x256, 512x512, 1024x1024, 1792x1024, or 1024x1792)
quality	str	"standard"	Image quality (standard or hd)
style	str	"vivid"	Image style (vivid or natural)
api_key	str	None	The OpenAI API key for authentication
all	bool	False	Enable all functionality when set to True

Toolkit Functions

Function	Description
generate_image	Generates an image based on a text prompt

Developer Resources

• View Tools