SAMMI Extensions
Lens Hopper
Early Release
This extension is in early access and may have bugs or issues. Please report them on Discord.
Turn any OBS scene/source, local image or image URL into AI art.
Features
- Select an OBS Scene/Source or an image as your starting point
- Choose the generated AI image size, quality and theme (or make a custom one!)
- Automatic moderation - inappropriate images will not be generated.
- Once the image is generated, it's saved in your SAMMI folder
- Automatically post the image to Discord or show in your OBS
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.
Setup
- Ensure you're using SAMMI 2025.1.1 or newer. The extension will not work with older versions.
- Install the extension. You can follow the Extension Install Guide.
- Setup your Settings button:
- API Key:
- Go to OpenAI.
- Create an account or log in.
- Access the API Keys page and create a new secret key.
- Enter the key in the OpenAI API box within the Settings button.
- Add your payment method in the Billing section and add credits to your balance or enable auto-recharge.
- Set your usage limits.
- API Key:
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.
Lens Hopper Take OBS Hop
Takes a new hop - turns an OBS scene/source into an AI image.
Moderation
An image can get flagged as inappropriate and fail to generate. In this case, the {variable name}_status will be set to "Image has been flagged as inappropriate and will not be generated."
| Box Name | Description |
|---|---|
| OBS Source Name | The source or scene you want to use as the source for the hop. |
| Style | Choose a premade style or input your own. |
| Quality | Premium uses high detail when using a vision model to 'see' the image and generates it as HD image. Standard uses low detail and generates it as standard image. Higher cost/longer processing times for premium. |
| Size | Size of the generated image (affects cost) |
| Save Variable As | Variable name to save the generated image into. Will be saved as 2 separate variables: variable name - full path to the generated image, set to "" if it failed. {variable name}_status - set to "ok" if everything went well, if not, contains the error message. |
Lens Hopper Image To Hop
Takes a new hop - turns an existing image into an AI image.
Moderation
An image can get flagged as inappropriate and fail to generate. In this case, the {variable name}_statuss will be set to "Image has been flagged as inappropriate and will not be generated."
| Box Name | Description |
|---|---|
| Image File Path | Local image path to turn into AI image (fill out one of these) |
| Image URL | Full image URL to turn into AI image (fill out one of these) |
| Style | Choose a premade style or input your own. |
| Quality | Premium uses high detail when using a vision model to 'see' the image and generates it as HD image. Standard uses low detail and generates it as standard image. Higher cost/longer processing times for premium. |
| Size | Size of the generated image (affects cost) |
| Save Variable As | Variable name to save the generated image into. Will be saved as 2 separate variables: variable name - full path to the generated image, set to "" if it failed. {variable name}_status - set to "ok" if everything went well, if not, contains the error message. |
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.