Google Imagen 3 - AI Image Generator (BYOK)

Generate AI images using Google's Imagen 3 model (imagen-3.0-generate-002). Bring Your Own Key (BYOK) - use your own Google AI API key. For Gemini Pro/Flash image generation, see AI Image Studio.

Features

• BYOK Model: Use your own Google AI API key - pay only for what you use directly to Google
• Multiple Variations: Generate 1-4 image variations per prompt
• Aspect Ratios: Square (1:1), Landscape (16:9), Portrait (9:16), and more
• Negative Prompts: Specify what to avoid in generated images
• Demo Mode: Test the actor without an API key

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Description
googleApiKey	string	Your Google AI Studio API key (get one free at aistudio.google.com)
prompt	string	Describe the image you want to generate
numberOfImages	integer	How many variations to generate (1-4, default: 4)
aspectRatio	string	Image dimensions: 1:1, 16:9, 9:16, 4:3, 3:4
negativePrompt	string	Things to avoid in the image (optional)
demoMode	boolean	Test with sample data (no API key needed)

Output Format

The actor outputs:

• Generated images saved to key-value store
• Public URLs for each image
• Metadata including prompt, aspect ratio, and generation timestamp

{
    "prompt": "A professional photo of a modern coffee shop...",
    "imageCount": 4,
    "aspectRatio": "16:9",
    "generatedAt": "2024-12-24T10:30:00Z",
    "images": [
        { "index": 1, "url": "https://...", "mimeType": "image/png" },
        { "index": 2, "url": "https://...", "mimeType": "image/png" },
        { "index": 3, "url": "https://...", "mimeType": "image/png" },
        { "index": 4, "url": "https://...", "mimeType": "image/png" }
    ]
}

Pricing

This actor uses pay-per-event billing: This actor uses the BYOK (Bring Your Own Key) model:

• Apify Usage: Standard compute costs (minimal - runs quickly)
• Google Imagen: Billed directly to your Google Cloud account
• Free Tier: Google provides generous free usage for AI Studio keys

Use Cases

• Marketing Content: Generate social media images, blog headers, ad creatives
• E-commerce: Product mockups, lifestyle images, banner designs
• Branding: Logo concepts, brand imagery, visual identity elements
• Content Creation: Thumbnail images, featured images, illustrations

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal