# AI Images Widget

The AI Images feature turns the `!imagine` chat command into a way for viewers to make AI-generated pictures during your stream. They type a prompt, KickBot generates the image, and it pops onto stream through a browser-source widget. KickBot can also reply in chat with a direct link to the finished image.

{% hint style="info" %}
This guide assumes you have a KickBot account with your Kick channel connected.
{% endhint %}

## Set up the !imagine command

Navigate to [kickbot.com/dashboard/imagine](https://kickbot.com/dashboard/imagine). The page has one main **Command Settings** card, plus a **Widget URL** box, a live **Widget Preview**, and a usage counter on the right.

<figure><img src="/files/GlqawU7c7r5yScTROcep" alt="KickBot AI image generation dashboard with command settings, widget URL, and usage meter"><figcaption><p>The AI Images page on the KickBot dashboard.</p></figcaption></figure>

To get the command running:

1. Toggle **Enabled** in the top-right of the Command Settings card.
2. Pick who can use the command under **Who Can Use**.
3. Choose your widget options and on-screen time.
4. Click **Save Changes**.
5. Copy the **Widget URL** and add it as a browser source in OBS or Streamlabs.

Once it is set up and the widget is on your scene, viewers type `!imagine` followed by a prompt (for example, `!imagine a mountain made of bananas`) and the generated image slides onto your stream.

## Command Settings

<figure><img src="/files/aMncwYpBoAd7jYcjtu0L" alt="Command Settings card for the Kick AI image bot with role toggles and widget options"><figcaption><p>The Command Settings card with default values.</p></figcaption></figure>

### Who Can Use

Four role toggles control who in your Kick chat can run `!imagine`. **Everyone** is selected by default, which is the typical setup for an open chat.

<figure><img src="/files/NTMJx5rbvc6K03HW5dWi" alt="Who Can Use roles with Subs and VIPs selected on the AI image command"><figcaption><p>For example, selecting Subs and VIPs limits image generation to those two roles.</p></figcaption></figure>

You can mix roles freely. With **Subs** and **VIPs** picked, only subscribers and VIPs can run the command and other viewers' messages are ignored. As the streamer you can always run `!imagine` regardless of which roles are selected.

### Widget Options

* **Show command example.** When on, the widget displays "Generate images with !imagine" along the top so new viewers know how to use it. On by default.
* **Respond with URL.** When on, KickBot replies in your Kick chat with a direct link to the finished image so the viewer who asked for it can save or share it. On by default.

### Widget Settings

* **On-screen time.** How long each image stays visible on the widget once it appears, in seconds. The slider goes from 5 to 300, default 60.
* **Transition.** How the image enters and exits the widget. Options are None, Fade, Slide from left, Slide from right, Slide from bottom (default), and Slide from top.

{% hint style="info" %}
Changing settings while you are live needs a refresh of the browser source in OBS or Streamlabs for the new values to take effect on stream.
{% endhint %}

## Test the widget without using chat

The Command Settings card has a **Send test image to OBS** button. Clicking it pushes a sample image (a flamingo lounge scene) straight to your widget through the same path a real `!imagine` command would use. If the widget is set up correctly, the test image appears on stream within a second.

<figure><img src="/files/byzE5LHmL60RS2B9YTtQ" alt="Widget Preview card showing a generated image with the username and prompt"><figcaption><p>The dashboard's Widget Preview mirrors what shows up on stream when an image generates.</p></figcaption></figure>

The dashboard also shows a live **Widget Preview** that reflects your current settings, so you can see how the on-screen time and transition look without going to OBS.

## Usage limits

Free accounts can generate up to 50 images every 30 days. Premium accounts can generate up to 1,000 every 30 days. The counter on the right side of the page shows how many images have been generated in your current 30-day window.

The window is rolling, not calendar-based: it always counts the last 30 days from now. Only images that successfully generate are counted; messages that fall outside your **Who Can Use** roles do not.

## If images are not appearing on stream

If a viewer runs `!imagine` and nothing shows up:

* **Check that KickBot is a moderator on your Kick channel.** This is the single most common cause of any KickBot chat-command issue. Add KickBot as a mod at [dashboard.kick.com/community/roles/moderator](https://dashboard.kick.com/community/roles/moderator).
* **Check the Enabled toggle.** The Command Settings header should read "Enabled" with a green switch.
* **Check Who Can Use.** A regular viewer running the command will be ignored if you only have Subs, VIPs, or Mods selected. Add **Everyone** to open the command up.
* **Reload your browser source.** OBS and Streamlabs need a refresh after any settings change for the new values to apply on stream.
* **Check your monthly usage.** The right-hand sidebar shows how many of your 50 (free) or 1,000 (premium) images have been used in the last 30 days.

## FAQ

<details>

<summary>How do I generate AI images on Kick?</summary>

Open [kickbot.com/dashboard/imagine](https://kickbot.com/dashboard/imagine), enable the command, choose who can use it, save the settings, and add the Widget URL as a browser source in OBS or Streamlabs. Viewers then type `!imagine` followed by a prompt to generate an image.

</details>

<details>

<summary>Can viewers create AI images in Kick chat?</summary>

Yes. Once you enable the `!imagine` command on your KickBot dashboard, anyone whose role matches your Who Can Use selection can type `!imagine` followed by a prompt in your Kick chat to generate an image.

</details>

<details>

<summary>How many AI images can my chat generate?</summary>

Free accounts get 50 images every 30 days. Premium accounts get 1,000 every 30 days. The window is rolling and the counter on the dashboard shows your current usage.

</details>

<details>

<summary>Do viewers get a link to the image they generated?</summary>

Yes, when **Respond with URL** is on. KickBot replies in chat with a direct link so the viewer who ran the command can open, save, or share the finished image. You can turn this off if you would rather keep the chat clean.

</details>

<details>

<summary>Can I keep the image on screen longer?</summary>

Yes. Use the **On-screen time** slider on the Command Settings card. It goes from 5 seconds up to 300 seconds (5 minutes). The default is 60 seconds.

</details>

## Need help?

If something is not working or you have a question this page did not cover, email <support@kickbot.com> or drop into the `#support` channel on the [KickBot Discord](https://discord.gg/MAg3gBbc89).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kickbot.com/dashboard/widgets/ai-images-widget.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.