AI Image Generator - SAMMI Extension

Easily generate and edit AI images with simple SAMMI commands using DALL-E.

Features

Generating images

Generate new image(s) based on a prompt with DALL-E 2 or DALL-E 3 models
Generate image variation(s) based on a provided image
Generate image edit(s) based on a provided image and mask.

Saving Images

Saves the generated image(s) to URL or to a file.

Verifying Prompts

Verify the prompt is safe before generating an image (0 cost)

User friendly

Lots of checks implemented to avoid sending invalid parameters to Open API
Automatically generates new file names to prevent overwriting old files
Saves image URLs or file paths in an array within the button for easy access
All image URLs are also saved in a text file to prevent loss in case of crashes

Setup

DALL-E Service Warning

DALL-E is a paid service requiring an OpenAI account and a credit card. Monitor your usage and set limits via the OpenAI dashboard.

Install the extension. You can follow the Extension Install Guide.
Setup your INIT button:
- API Key:
  1. Go to OpenAI.
  2. Create an account or log in.
  3. Access the API Keys page and create a new secret key.
  4. Enter the key in the OpenAI API box within the INIT button.
  5. Add your payment method in the Billing section and add credits to your balance or enable auto-recharge.
  6. Set your usage limits.

Available Commands

Command Usage Reminder

These commands require a waiting period before 'Save Variable As' is populated. Use the Wait Until Variable Exists command, and remember to delete the variable you're waiting for beforehand.

DALL-E Generate (DALL-E 2)

Generates a new image based on a prompt using the DALL-E 2 model.

Box Name	Description
Prompt	The image description (max 1000 characters). The more detailed, the better.
Amount	Number of images to generate (1–10).
Size	Size of the generated image.
Response	Save the image as a file or URL. If saving it as a file, it will be saved in your SAMMI folder/Ext/image generations. To prevent files from being accidentally overridden, the filename is automatically generated in the following format: `DALL·E {timestamp} - {truncated prompt}_{index}.png`
Save As Variable	Variable to save the result into, won't be set at all if generating failed. If saving the image as a file, it will be an array containing all image file paths. If saving the image as a URL, it will be an array containing all image URLs.
Save as (status)	Variable name to save the status result (`1` for success, `0` for failure).

DALL-E 3 Generate

Generates a new image based on a prompt using the DALL-E 3 model.

Box Name	Description
Prompt	The image description (max 1000 characters). The more detailed, the better.
Amount	Number of images to generate (currently supports 1 image).
Quality	HD for higher quality, or Standard for regular quality.
Size	Size of the generated image.
Style	Vivid for hyper-realism, or Natural for more realistic images.
Response	Save the image as a file or URL. If saving it as a file, it will be saved in your SAMMI folder/Ext/image generations. To prevent files from being accidentally overridden, the filename is automatically generated in the following format: `DALL·E {timestamp} - {truncated prompt}_{index}.png`
Save As Variable	Variable to save the result into, won't be set at all if generating failed. If saving the image as a file, it will be an array containing all image file paths. If saving the image as a URL, it will be an array containing all image URLs.
Save as (status)	Variable name to save the status result (`1` for success, `0` for failure).

DALL-E Variations

Generates image variations based on a supplied image using the DALL-E 2 model.

Box Name	Description
Image File Path	The image to use as the basis for the variation(s). Must be a valid PNG file, less than 4MB, and square
Amount	Number of images to generate (1–10).
Size	Size of the generated images.
Response	Save the image as a file or as a URL. If saving it as a file, it will be saved in your SAMMI folder/Ext/image generations. To prevent files from being accidentally overridden, the filename is automatically generated in the following format: `DALL·E Variations {timestamp} - {filename}_{index}.png`
Save As Variable	Variable to save the result into. If saving the image as a file, it will be an array containing all image file paths. If saving the image as a URL, it will be an array containing all image URLs.
Save as (status)	Variable name to save the status result (`1` for success, `0` for failure).

DALL-E Edit

Creates an edited image based on an original image and a prompt using the DALL-E 2 model.

Box Name	Description
Image File Path	The image to edit, must be a valid PNG file, less than 4MB, and square.
Mask File Path	An additional image whose fully transparent areas indicate where the image should be edited. Must be a valid PNG file, less than 4MB, and square.
Prompt	Description of the desired edit (max 1000 characters).
Amount	Number of images to generate (1–10).
Size	Size of the generated image.
Response	Save the image as a file or as a URL. If saving it as a file, it will be saved in your SAMMI folder/Ext/image generations. To prevent files from being accidentally overridden, the filename is automatically generated in the following format: `DALL·E Variations {timestamp} - {filename}_{index}.png`
Save As Variable	Variable to save the result into. If saving the image as a file, it will be an array containing all image file paths. If saving the image as a URL, it will be an array containing all image URLs.
Save as (status)	Variable name to save the status result (`1` for success, `0` for failure).

DALL-E Verify Prompt

Verifies the prompt is safe before attempting to generate an image. This is a free endpoint.

The response will contain an object with detailed categories and their scores.
The easiest way to see if the prompt has been tagged is to check the flagged key.

Box Name	Description
Prompt	The prompt to verify.
Save As Variable	Variable name to save the verification result.
Save as (status)	Variable name to save the status result (`1` for success, `0` for failure).

By installing this extension, you agree to monitor your usage and cost. If you notice high usage, please uninstall and report it to Christina on Itch or Discord.

Get Help

Please see Troubleshooting for common extensions issues.