"Ideogram 3.0 API Pricing & Integration Guide for Developers 2026"

import requests
import base64
from io import BytesIO
from PIL import Image

IDEOGRAM_API_KEY = "your-api-key"
BASE_URL = "https://api.ideogram.ai/v1"

headers = {
    "Api-Key": IDEOGRAM_API_KEY,
    "Content-Type": "application/json"
}

def generate_image(prompt: str, aspect_ratio: str = "1x1",
                   style: str = None, magic_prompt: bool = True):
    """Generate an image with Ideogram 3.0"""
    
    payload = {
        "image_request": {
            "prompt": prompt,
            "aspect_ratio": aspect_ratio,
            "model": "V_3",  # Ideogram 3.0
            "magic_prompt_option": "AUTO" if magic_prompt else "OFF",
        }
    }
    
    if style:
        payload["image_request"]["style_type"] = style
    
    response = requests.post(
        f"{BASE_URL}/ideogram-generate",
        headers=headers,
        json=payload
    )
    response.raise_for_status()
    
    data = response.json()
    return data["data"][0]["url"]

# Generate a logo with text
url = generate_image(
    prompt='A modern tech company logo with the text "NexaFlow" in bold '
           'geometric font, blue and white color scheme, minimalist design',
    aspect_ratio="1x1",
    style="GENERAL",
    magic_prompt=True
)
print(f"Image URL: {url}")

# Social media graphic with text
url = generate_image(
    prompt='Instagram post for a coffee shop. Text overlay reads "Monday '
           'Morning Fuel" in white script font. Background: steaming latte '
           'art, warm brown tones, cozy cafe atmosphere. Professional quality.',
    aspect_ratio="4x5",  # Instagram portrait
    style="PHOTO"
)

# Product label
url = generate_image(
    prompt='Product label for artisan hot sauce. Brand name "BLAZING FARMS" '
           'in rustic western font at top. Subtitle "Habanero Gold" in smaller '
           'text. Ingredients list at bottom. Vintage illustration of peppers '
           'in center. Red, gold, and cream color palette.',
    aspect_ratio="2x3",
    style="ILLUSTRATION"
)

# Event poster
url = generate_image(
    prompt='Music festival poster. Title "NEON NIGHTS FESTIVAL" in large '
           'glowing neon text. "August 15-17, 2026" below. "Berlin, Germany" '
           'at bottom. Psychedelic background with geometric patterns. '
           'Purple, pink, and electric blue colors.',
    aspect_ratio="2x3",
    style="GRAPHIC_DESIGN_3D"
)

import asyncio
import aiohttp

async def generate_batch(prompts: list, max_concurrent: int = 5):
    """Generate multiple images concurrently"""
    semaphore = asyncio.Semaphore(max_concurrent)
    
    async def generate_one(prompt, session):
        async with semaphore:
            async with session.post(
                f"{BASE_URL}/ideogram-generate",
                headers=headers,
                json={
                    "image_request": {
                        "prompt": prompt,
                        "model": "V_3",
                        "magic_prompt_option": "AUTO"
                    }
                }
            ) as resp:
                data = await resp.json()
                return data["data"][0]["url"]
    
    async with aiohttp.ClientSession() as session:
        tasks = [generate_one(p, session) for p in prompts]
        return await asyncio.gather(*tasks, return_exceptions=True)

# Generate 20 product variants
prompts = [
    f'Product tag for "{flavor}" flavor artisan jam, vintage illustration, '
    f'rustic font, "{flavor}" text prominently displayed'
    for flavor in ["Strawberry", "Blueberry", "Peach", "Mango", "Raspberry",
                   "Blackberry", "Apricot", "Fig", "Cherry", "Plum",
                   "Elderflower", "Lavender", "Vanilla", "Cinnamon", "Ginger",
                   "Cardamom", "Rose", "Hibiscus", "Lemon", "Orange"]
]

results = asyncio.run(generate_batch(prompts))

import base64

def remix_image(image_url: str, prompt: str, 
                strength: float = 0.5):
    """Create variations of an existing image"""
    
    # Download and encode source image
    img_resp = requests.get(image_url)
    img_b64 = base64.b64encode(img_resp.content).decode()
    
    response = requests.post(
        f"{BASE_URL}/ideogram-remix",
        headers=headers,
        json={
            "image_request": {
                "prompt": prompt,
                "image_weight": strength,  # 0=full prompt, 1=full image
                "model": "V_3",
                "magic_prompt_option": "AUTO"
            },
            "image_file": {
                "content_type": "image/jpeg",
                "image": img_b64
            }
        }
    )
    return response.json()["data"][0]["url"]

# Create product variations
variations = [
    remix_image(
        "https://example.com/product_base.jpg",
        f"Same product in {color} color variant, same lighting and angle",
        strength=0.6
    )
    for color in ["red", "blue", "black", "white", "gold"]
]

import openai

client = openai.OpenAI(
    api_key="sk-cr-your-key",
    base_url="https://crazyrouter.com/v1"
)

# Generate with Ideogram through Crazyrouter
response = client.images.generate(
    model="ideogram-3",
    prompt='Clean UI mockup for a fintech app. Header reads "Your Balance" '
           'with a large number "$12,450.00" in the center. '
           'Modern flat design, blue gradient background.',
    size="1024x1024"
)

image_url = response.data[0].url

# cURL via Crazyrouter
curl https://crazyrouter.com/v1/images/generations \
  -H "Authorization: Bearer sk-cr-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram-3",
    "prompt": "App store screenshot for a productivity app showing the main dashboard",
    "size": "1024x2048"
  }'

# Turn off for tested, refined prompts
payload["image_request"]["magic_prompt_option"] = "OFF"

# Draft iteration at standard quality
draft = generate_image(prompt, quality="standard")  # $0.02

# Final render at high quality  
final = generate_image(refined_prompt, quality="high")  # $0.04