Image Generation Skill

Purpose: Generate images using AI image generation APIs (Google Gemini, FLUX.2 via Replicate, DALL-E, or similar).

PLATFORM-SPECIFIC REQUIREMENTS

Bluesky Compression (MANDATORY for posts)

Bluesky REJECTS images >976KB. Always compress:

from PIL import Image

def compress_for_bluesky(input_path: str, output_path: str):
    """Compress image for Bluesky (<976KB requirement)."""
    img = Image.open(input_path)
    if img.mode in ('RGBA', 'P'):
        img = img.convert('RGB')
    img.save(output_path, "JPEG", quality=85, optimize=True)
    print(f"Compressed: {output_path}")

Quick Start (Google Gemini)

from google import genai
from google.genai import types
import os

client = genai.Client(api_key=os.environ['GOOGLE_API_KEY'])

# Generate image
response = client.models.generate_content(
    model="gemini-3-pro-image-preview",
    contents="A digital art piece showing interconnected nodes in a constellation pattern",
    config=types.GenerateContentConfig(
        response_modalities=['IMAGE'],
        image_config=types.ImageConfig(
            aspect_ratio="16:9",
            image_size="2K"
        ),
    )
)

# Save image
for part in response.parts:
    if part.inline_data is not None:
        image = part.as_image()
        image.save("output.png")
        print("Image saved!")

Aspect Ratios

Image Resolution

Text in Images

Modern AI image generators (especially Gemini) excel at text rendering. Use this capability.

Great uses for text in images:

• Quote cards: Include the quote directly in the image
• Titles/Headlines: Blog titles, thread hooks
• Infographics: Labels, data points, explanations
• Branding: Your brand name, tagline
• Call-to-action: "Read more", "Thread below"

How to request text:

prompt = """Quote card with the text "Memory is our moat" in bold white typography.
Dark blue gradient background.
Text should be LARGE and CENTERED.
Professional design, clean composition."""

Be explicit: "Write 'HELLO' in bold serif font" creates clearer results than vague requests.

Style Keywords That Work Well

• Photography terms: "35mm prime lens", "macro close-up", "film grain", "bokeh"
• Quality modifiers: "8K quality", "high detail", "professional photography"
• Lighting descriptors: "Rembrandt lighting", "golden hour", "backlit", "dramatic"

Complete Function

import os
from pathlib import Path
from google import genai
from google.genai import types

def generate_image(
    prompt: str,
    output_path: str = "output.png",
    aspect_ratio: str = "16:9",
    image_size: str = "2K"
):
    """
    Generate an image using an AI image generation API.

    Args:
        prompt: Text description of the image to generate
        output_path: Where to save the image
        aspect_ratio: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9
        image_size: "1K", "2K", or "4K"

    Returns:
        Saved file path, or None if generation failed
    """
    client = genai.Client(api_key=os.environ['GOOGLE_API_KEY'])

    response = client.models.generate_content(
        model="gemini-3-pro-image-preview",
        contents=prompt,
        config=types.GenerateContentConfig(
            response_modalities=['IMAGE'],
            image_config=types.ImageConfig(
                aspect_ratio=aspect_ratio,
                image_size=image_size
            ),
        )
    )

    for part in response.parts:
        if part.inline_data is not None:
            image = part.as_image()
            image.save(output_path)
            print(f"Saved to: {output_path}")
            return output_path

    print("No image generated")
    return None

Use Case Examples

Blog Header (16:9, 2K)

generate_image(
    prompt="Blog header for article about AI and marketing. Abstract neural network with glowing nodes. Modern tech aesthetic. Include title 'The Future of Marketing' in bold white.",
    output_path="blog-header.png",
    aspect_ratio="16:9",
    image_size="2K"
)

Social Media Post (1:1, 1K)

generate_image(
    prompt="Square social media graphic showing AI collaboration. Abstract, modern, professional.",
    output_path="social-image.png",
    aspect_ratio="1:1",
    image_size="1K"
)

Quote Card

generate_image(
    prompt='Quote card with text "Data without insight is just noise" in elegant typography. Dark background, golden text, professional design.',
    output_path="quote-card.png",
    aspect_ratio="1:1",
    image_size="2K"
)

Troubleshooting

Built by PureBrain -- AI-powered marketing operations.

Want the full suite of 183+ production-tested skills? Start your trial ->