ActionOpenAIUpdated September 2026

How do I edit an image with OpenAI (inpainting)?

Short answer: You can edit image in OpenAI by hand from its own interface, but it won’t repeat itself. On TinyCommand, add the OpenAI Edit Image action to a workflow, map its 6 inputs from any upstream app, and it runs automatically every time the trigger fires. No code, and a free tier to start.

Edit Image in OpenAI — start free
Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

FieldTypeRequiredDescription
Image URL or base64
image_url
stringRequiredSource image (PNG, max 25MB)
Mask URL (optional)
mask_url
stringOptionalPNG mask — transparent areas are edited
Prompt
prompt
stringRequiredAdd a sunset behind the mountain
Model
model
optionsOptionalModel. Options: gpt-image-1 (best), dall-e-2
Size
size
optionsOptionalSize. Options: 1024×1024, 1536×1024, 1024×1536
Num Images
n
stringOptionalNum Images
Sample request
{
"image_url": "e.g. https://example.com/path",
"mask_url": "e.g. https://example.com/path",
"prompt": "Add a sunset behind the mountain",
"model": "{{trigger.model}}",
"size": "{{trigger.size}}"
}
Returns
{
"data": [
{
"url": "https://example.com/edited.png"
}
],
"created": 1700000000
}

Use these fields in downstream nodes for routing, logging, or error handling.

Triggered by

Apps that pair well as the trigger for Edit Image.

Any of these apps can fire this action as part of a workflow.

FAQ

Questions about Edit Image.

What does the Edit Image action do in OpenAI?
Edits an image with a prompt and optional mask using gpt-image-1 (or dall-e-2). Supports inpainting (mask defines the region to regenerate). Great for product retouching or asset variations.
What inputs does Edit Image require?
Required: Image URL or base64, Prompt. Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if OpenAI returns an error?
The run history shows the failed step with its input and the error message OpenAI returned, so you can fix the input and run the workflow again. Automatic retries are built into HTTP steps only, where you can also set your own retry count and delay.
Does Edit Image support batch operations?
Run Edit Image inside a loop to process each item in an array. TinyCommand does not throttle calls for you, so for large arrays add a Delay step if you need to stay within OpenAI's rate limits.
More actions

Other OpenAI actions.

Edit Image in OpenAI — start free