Where this works

You can use AI image tools in:

• the postcard composer (/)
• the template editor (/templates/new)

Hourly usage limits

To keep these tools available for real postcard workflows (and prevent free-bulk image utility abuse), AI image features are rate-limited per hour:

• AI image generation (low quality):
  • guest: 12 per hour
  • signed in: 36 per hour
• AI image generation (medium/high/auto quality):
  • guest: 4 per hour
  • signed in: 12 per hour
• Background removal:
  • guest: 40 per hour
  • signed in: 120 per hour

Limits are enforced by user account when signed in, and by network/device fingerprint when signed out.

Generate a new image with AI (composer)

1. Open the postcard composer.
2. Click AI mode in the image panel.
3. Enter a prompt in: Describe your postcard's image and create it with AI...
4. Optional: add reference images.
5. Click Generate image (or use Cmd/Ctrl+Enter).

The generated image is applied to the postcard image slot.

Modify an uploaded image (composer)

1. Switch to upload mode and upload a photo.
2. Click Remove background.

This removes the current image background and enables automatic background removal for later uploads/imports in that image slot.

Generate and modify images in the template editor

1. Open /templates/new.
2. Select an image layer in the canvas.
3. In the inspector:
   • use AI mode for prompt-based generation
   • use Upload for manual image upload
   • use the gear icon for Image generation settings (model, quality, size)
4. Click the generate action (up-arrow) or press Cmd/Ctrl+Enter.

You can also:

• add reference images (+) for guided generation
• clear references (n ref chip)
• use Remove background + enable auto mode

AI backgrounds for containers/text (template editor)

For container and text blocks, enable Background image, switch to AI mode, then:

1. Enter a background prompt.
2. Optionally add reference images.
3. Generate with the up-arrow button (Cmd/Ctrl+Enter).

APIs behind these features

• POST /api/postcard/generate
• POST /api/postcard/remove-background