Skip to main content

Overview

Generate images from text prompts using DALL-E and other image generation models.

Python Usage

Basic Image Generation

from praisonai.capabilities import image_generate

result = image_generate(
    prompt="A sunset over mountains",
    model="dall-e-3",
    size="1024x1024"
)

print(f"URL: {result[0].url}")
print(f"Revised prompt: {result[0].revised_prompt}")

DALL-E 2 (Faster, Lower Cost)

from praisonai.capabilities import image_generate

result = image_generate(
    prompt="A blue circle on white background",
    model="dall-e-2",
    size="256x256",
    n=1
)

print(f"URL: {result[0].url}")

Save Image to File

from praisonai.capabilities import image_generate

result = image_generate(
    prompt="A beautiful landscape",
    model="dall-e-3"
)

# Save to file
result[0].save("landscape.png")

Async Usage

import asyncio
from praisonai.capabilities import aimage_generate

async def main():
    result = await aimage_generate(
        prompt="A futuristic city",
        model="dall-e-3"
    )
    print(f"URL: {result[0].url}")

asyncio.run(main())

Parameters

ParameterTypeDefaultDescription
promptstrRequiredImage description
modelstr”dall-e-3”Model to use
nint1Number of images
sizestr”1024x1024”Image size
qualitystr”standard""standard” or “hd” (DALL-E 3 only)
stylestrNone”vivid” or “natural” (DALL-E 3 only)
response_formatstr”url""url” or “b64_json”
timeoutfloat600.0Request timeout

Result Object

The ImageResult object contains:
  • url: Image URL
  • b64_json: Base64 encoded image (if requested)
  • revised_prompt: DALL-E 3’s revised prompt
  • model: Model used
  • save(path): Method to save image to file