Generate Ad Images

Generate two distinct image variations for advertising campaigns using Google Gemini API. Each variation should be visually distinct, platform-optimized, and aligned with campaign goals.

Workflow

Step 1: Analyze Campaign Context

Extract from provided parameters:

• •product_or_service: What is being advertised
• •target_audience: Who the ad targets
• •platform: Where ad appears (TikTok, Facebook, Instagram, LinkedIn)
• •creative_direction: Tone and style requirements
• •kpi: Success metrics

If research insights provided, incorporate audience behaviors, platform trends, and creative recommendations.

Step 2: Determine Dimensions

Select dimensions based on platform. See references/platform-guidelines.md for full details.

Default to 1080×1080 if no platform specified.

Step 3: Create Variation A Prompt

Build a detailed image generation prompt including:

• •Product/service representation
• •Target audience representation (if appropriate)
• •Platform-appropriate composition
• •Style matching creative direction
• •Dimensions specification
• •"No text overlays" instruction
• •"Leave space for text" instruction

Step 4: Execute Script for Variation A

Run the Python script:

python scripts/generate_image.py --prompt "[your prompt]" --variation "A" --aspect-ratio "[ratio]"

Aspect ratio options: 1:1, 3:4, 4:3, 9:16, 16:9

The script returns JSON with image_data (base64), mime_type, and variation_id.

Step 5: Create Variation B Prompt

Create a DISTINCT prompt with different:

• •Composition or angle
• •Visual style or mood
• •Focus or emphasis

Variation B must NOT be a minor variation of A. Provide genuine alternative for A/B testing.

Step 6: Execute Script for Variation B

python scripts/generate_image.py --prompt "[your prompt]" --variation "B" --aspect-ratio "[ratio]"

Step 7: Determine Recommendation

Analyze both variations and recommend one based on:

• •Campaign KPI alignment
• •Platform best practices
• •Audience appeal from insights

Step 8: Return JSON Output

CRITICAL: Return a raw JSON object as plain text (NOT wrapped in markdown code blocks like ```json). The output must be valid JSON that can be parsed directly by the calling service.

Return this exact structure:

{ "generated_at": "ISO timestamp (e.g., 2024-01-15T10:30:00Z)", "campaign_name": "name or null", "platform": "platform name (lowercase, e.g., tiktok, instagram_feed)", "target_audience": "audience description", "variations": [ { "variation_id": "A", "image_url": "URL from script output (required)", "thumbnail_url": "thumbnail URL from script or null", "file_id": "file ID from script or null", "mime_type": "image/png or image/jpeg", "prompt_used": "full prompt used for generation", "visual_approach": "brief description of visual approach (1-2 sentences)", "dimensions": { "width": 1080, "height": 1920 } }, { "variation_id": "B", "image_url": "URL from script output (required)", "thumbnail_url": "thumbnail URL from script or null", "file_id": "file ID from script or null", "mime_type": "image/png or image/jpeg", "prompt_used": "full prompt used for generation", "visual_approach": "brief description of visual approach (1-2 sentences)", "dimensions": { "width": 1080, "height": 1920 } } ], "recommended_variation": "A or B", "recommendation_rationale": "2-3 sentences explaining why this variation is recommended based on campaign goals, platform best practices, and audience appeal" }

References

• •Platform Guidelines: See references/platform-guidelines.md for platform-specific dimensions, optimization tips, and creative direction alignment
• •Examples: See references/examples.md for complete input/output examples

Important Notes

• •Return raw JSON only, not wrapped in code blocks
• •Generate exactly two variations with distinct visual approaches
• •Ensure images are platform-optimized with correct dimensions
• •Leave space for text overlays (headlines, CTAs)
• •Avoid text, logos, or copyrighted elements in generated images
• •Match tone and style to creative direction
• •Provide clear rationale for recommendation
• •Ensure variation B is genuinely different from A