> For the complete documentation index, see [llms.txt](https://docs.ideogram.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ideogram.ai/plans-and-pricing/ideogram-api/playground.md).

# Playground

The **Playground** section of the [API Dashboard](/using-ideogram/ui-overview/pages-ui/api-dashboard.md) sidebar (Generate, Remix, Remove background) lets you run real API requests from the browser — no code required. It's the quickest way to try an endpoint, see the exact cURL command for a request, and inspect the raw JSON response before writing your integration. Playground requests use your API key and consume API credits like any other API call.

Each Playground page starts with an **API key** field: paste an existing key or click **New key** to create one. The key is kept in memory only and must be re-entered after a page refresh. For full request and response schemas, see [developer.ideogram.ai](https://developer.ideogram.ai).

## Generate

The Generate page builds a text-to-image request. Write your prompt in the **Text prompt** tab, then set the resolution, rendering speed, and whether to opt the request into post-generation copyright detection. Each form field is labeled with its API parameter name (for example `resolution`, `rendering_speed`), and the **cURL request** block below the form updates live as you change settings — copy it to reproduce the same request from your terminal.

<figure><img src="/files/TudOLgjIZBq1wAuEWEWj" alt="Playground Generate page with the Text prompt and JSON prompt tabs and the Generate button highlighted, showing prompt, resolution, and rendering speed fields above a live cURL request preview"><figcaption><p>The Generate form. The cURL block mirrors your current settings; click <strong>Generate</strong> to run the request.</p></figcaption></figure>

Switch to the **JSON prompt** tab to describe the image as structured JSON instead of free text — useful for precise control over scene, subject, and style attributes. See [JSON Prompting](/using-ideogram/getting-started/prompting-guide/4.-json-prompting-ideogram-4.0.md) for how to structure these prompts.

<figure><img src="/files/ra8jYTiHqYjTzEambhOz" alt="Playground Generate page with the JSON prompt tab highlighted, showing a structured JSON prompt in the editor and the corresponding cURL request below"><figcaption><p>The <strong>JSON prompt</strong> tab accepts a structured prompt in place of free text.</p></figcaption></figure>

When the request completes, the **Output** panel on the right shows the generated image alongside the full JSON response — including the image URL, resolution, seed, and safety fields your integration will receive.

<figure><img src="/files/CrYH0XYpU8vBXBTVaiOB" alt="Playground Generate output panel showing a generated image of a cat next to the raw JSON API response with resolution, seed, and style fields"><figcaption><p>The Output panel: the generated image plus the raw JSON response.</p></figcaption></figure>

## Remix

The Remix page reworks an existing image with a prompt. Upload an **initial image** (PNG, JPEG, or WebP), describe the change in the **Prompt** field, and set the **image weight** — higher values stay closer to the original image, lower values give the prompt more influence. Resolution, rendering speed, and copyright detection work the same as on Generate.

<figure><img src="/files/8AvAA6AKAYbxm5UfBcRn" alt="Playground Remix page with the initial image upload area and the Remix button highlighted, showing prompt, image weight slider, resolution, and rendering speed fields with a cURL request preview"><figcaption><p>The Remix form: upload an initial image, add a prompt, and balance the two with <strong>image weight</strong>.</p></figcaption></figure>

For example, starting from this photo as the initial image:

<figure><img src="/files/ITo3ZGSR4IWArVlQL3ZI" alt="Photo of a wild turkey standing on a lawn, used as the initial image for the Remix example"><figcaption><p>The initial image uploaded in this example.</p></figcaption></figure>

With the prompt "Restyle this image as a vibrant watercolor painting," the Output panel shows the remixed result and its JSON response, so you can compare it against the original and adjust the image weight or prompt.

<figure><img src="/files/DNR0S9RKc5dsukxBMvfS" alt="Playground Remix output panel showing a watercolor-style remixed image of a turkey next to the raw JSON API response"><figcaption><p>The Remix result: the photo restyled as a watercolor painting, with the raw response alongside.</p></figcaption></figure>

## Remove background

The Remove background page takes a single image upload (PNG, JPEG, or WebP) and returns it with the background removed — there are no other parameters. The cURL block shows the equivalent command for your own scripts.

<figure><img src="/files/MSsCdFO4wTMsaDco6WYA" alt="Playground Remove background page with the Remove background button highlighted, showing an image upload area and the cURL request preview"><figcaption><p>Remove background: upload an image and run — no other settings.</p></figcaption></figure>

The Output panel shows the cut-out result on a transparent background, and the JSON response includes the URL for downloading it. Here the background of the turkey photo from the Remix example has been removed.

<figure><img src="/files/yTTAqh6803GST1PQbkOy" alt="Playground Remove background output panel showing the turkey cut out from its background next to the raw JSON API response"><figcaption><p>The result: the subject isolated from its background, with the raw response alongside.</p></figcaption></figure>