Image generation

Endpoint

POST /v3/universal-ai (sync) Model string pattern: image/generation/{provider}[/{model}]

Input

Field	Type	Required	Description
text	string	Yes	Text prompt for image generation
resolution	string	No	Image resolution as a named size (e.g. ‘1024x1024’). Optional: providers may also accept native sizing knobs (width/height, aspect_ratio, image_size tier, etc.) via `provider_params`, in which case `provider_params` takes precedence.
num_images	int	No	Number of images to generate
reference_images	array[file_input \| object]	No	Optional reference images. Plain file IDs/URLs are treated as ReferenceImage with kind=None. Support and per-model limits vary by model; models that do not accept reference images surface the error as status=“fail” with a provider message in the response body.
mask	file_input	No	Optional inpainting mask. Must be paired with at least one reference image (otherwise the request returns 422). Support varies by model; models that do not accept a mask surface the error as status=“fail” with a provider message in the response body.

Output

Field	Type	Required	Description
image	string	Yes
image_resource_url	string	Yes

Available Providers

Provider	Model String	Price
bytedance	`image/generation/bytedance`	$0.03 per request
bytedance (seedream-3-0-t2i-250415)	`image/generation/bytedance/seedream-3-0-t2i-250415`	$0.03 per request
bytedance (seedream-4-0-250828)	`image/generation/bytedance/seedream-4-0-250828`	$0.03 per request
bytedance (seedream-4-5-251128)	`image/generation/bytedance/seedream-4-5-251128`	$0.03 per request
bytedance (seedream-5-0-260128)	`image/generation/bytedance/seedream-5-0-260128`	$0.035 per image
google	`image/generation/google`	$0.04 per image
google (gemini-2.5-flash-image)	`image/generation/google/gemini-2.5-flash-image`	$0.039 per image
google (gemini-3-pro-image-preview)	`image/generation/google/gemini-3-pro-image-preview`	$0.039 per image
google (imagen-3.0-capability-001)	`image/generation/google/imagen-3.0-capability-001`	$0.04 per image
google (imagen-3.0-fast-generate-001)	`image/generation/google/imagen-3.0-fast-generate-001`	$0.02 per image
google (imagen-3.0-generate-001)	`image/generation/google/imagen-3.0-generate-001`	$0.04 per image
google (imagen-3.0-generate-002)	`image/generation/google/imagen-3.0-generate-002`	$0.04 per image
google (imagen-4.0-fast-generate-001)	`image/generation/google/imagen-4.0-fast-generate-001`	$0.02 per image
google (imagen-4.0-generate-001)	`image/generation/google/imagen-4.0-generate-001`	$0.04 per image
google (imagen-4.0-ultra-generate-001)	`image/generation/google/imagen-4.0-ultra-generate-001`	$0.06 per image
leonardo (AlbedoBase XL)	`image/generation/leonardo/AlbedoBase XL`	$0.017 per image
leonardo	`image/generation/leonardo`	$0.017 per image
leonardo (Leonardo Anime XL)	`image/generation/leonardo/Leonardo Anime XL`	$0.011 per image
leonardo (Leonardo Diffusion XL)	`image/generation/leonardo/Leonardo Diffusion XL`	$0.017 per image
leonardo (Leonardo Kino XL)	`image/generation/leonardo/Leonardo Kino XL`	$0.014 per image
leonardo (Leonardo Lightning XL)	`image/generation/leonardo/Leonardo Lightning XL`	$0.011 per image
leonardo (Leonardo Phoenix)	`image/generation/leonardo/Leonardo Phoenix`	$0.014 per image
leonardo (Leonardo Vision XL)	`image/generation/leonardo/Leonardo Vision XL`	$0.014 per image
leonardo (SDXL 0.9)	`image/generation/leonardo/SDXL 0.9`	$0.017 per image
minimax	`image/generation/minimax`	$0.0035 per image
minimax (image-01)	`image/generation/minimax/image-01`	$0.0035 per image
openai	`image/generation/openai`	$0.034 per image
openai (gpt-image-1)	`image/generation/openai/gpt-image-1`	$0.042 per image
openai (gpt-image-1.5)	`image/generation/openai/gpt-image-1.5`	$0.034 per image
openai (gpt-image-1-mini)	`image/generation/openai/gpt-image-1-mini`	$0.011 per image
openai (gpt-image-2)	`image/generation/openai/gpt-image-2`	$0.053 per image
replicate (anime-style)	`image/generation/replicate/anime-style`	$0.000225 per exec_time
replicate (classic)	`image/generation/replicate/classic`	$0.00115 per exec_time
replicate	`image/generation/replicate`	$0.01 per request
replicate (vintedois-diffusion)	`image/generation/replicate/vintedois-diffusion`	$0.000225 per exec_time
stabilityai	`image/generation/stabilityai`	$15 per 1,000 images
stabilityai (stable-diffusion-xl-1024-v1-0)	`image/generation/stabilityai/stable-diffusion-xl-1024-v1-0`	$15 per 1,000 images

Quick Start

import requests

url = "https://api.edenai.run/v3/universal-ai"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

payload = {
    "model": "image/generation/bytedance",
    "input": {
        "text": "The quick brown fox jumps over the lazy dog."
    }
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

curl -X POST https://api.edenai.run/v3/universal-ai \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image/generation/bytedance",
    "input": {"text": "The quick brown fox jumps over the lazy dog."}
  }'

V3 Documentation

Quick Start

Overview

LLMs

Expert Models

General

Organization

Data Governance

Integrations

Endpoint

Input

Output

Available Providers

Quick Start

​Endpoint

​Input

​Output

​Available Providers

​Quick Start

Endpoint

Input

Output

Available Providers

Quick Start