# OpenAI Image

Use [GC OpenAI](https://gravitywiz.com/documentation/gravity-connect-openai/) to generate one image from a prompt, then pass the saved file to later steps. If GC OpenAI is not active, Flowcrafter advertises this node as a locked integration.

![AI Image settings with a flow tag-aware event badge prompt](/documentation/flowcrafter/screenshots/ai-image-settings.png)

## When to use it

Use OpenAI Image for submission-specific artwork, certificates, mockups, or other images that need form values or earlier results in the prompt. Use [OpenAI Text](/documentation/flowcrafter/nodes/actions/ai-text/) when you need written content instead.

![OpenAI Image connected to Form Submitted](/documentation/flowcrafter/screenshots/action-ai-image-workflow.png)

## OpenAI connection

Activate GC OpenAI, then enter an API key in the node's **OpenAI connection** panel and choose **Save & test**. **Test saved key** checks the current connection without showing its key. You can also configure the connection under **Forms → Settings → OpenAI**.

The connection is shared by all GC OpenAI fields, feeds, and workflow nodes; changing it requires GC OpenAI settings permission and does not put the key in this workflow. A failed test does not replace the saved key.

The quick test checks model-list access without generating an image. Image-model permissions and generation quota may still differ.

![The connection panel in OpenAI Text; OpenAI Image uses the same shared key and controls](/documentation/flowcrafter/screenshots/action-openai-connection.png)

## Settings

A node test uses the real OpenAI integration and can incur usage charges.

| Setting | What it controls |
| --- | --- |
| Image Prompt | The image description. It must resolve to non-empty text and supports [flow tags](/documentation/flowcrafter/building/using-flow-tags/). |
| Model | An OpenAI image model offered by GC OpenAI. |
| Size | Square, landscape, or portrait OpenAI dimensions. |
| Quality | OpenAI's automatic, low, medium, or high quality. |
| Background | Automatic, opaque, or transparent background handling. |
| Output Format | PNG, JPEG, or WebP. |

## Output and branches

The single output provides **Image URL**, **Image Path**, filename, MIME type, byte size, model ID and name, and OpenAI's revised prompt when available.

The image is stored in Flowcrafter's private uploads area, **not** the WordPress Media Library. **Image URL** is a signed Flowcrafter download URL; **Image Path** is the relative private-storage path and is useful for [Send Email](/documentation/flowcrafter/nodes/actions/send-email/) attachments. The step fails rather than returning a temporary OpenAI URL if the file cannot be saved.

## Example

Set **Image Prompt** to `A clean square event badge for {{ "Form Submitted"["1"] }}, navy and gold, no photograph`, then use **Image Path** as a Send Email attachment.

This example shows configuration only; no image has been generated.

![OpenAI Image settings use the submitter's name in a navy-and-gold square badge prompt](/documentation/flowcrafter/screenshots/action-ai-image-settings.png)