Home / Servers / OpenAI API / create_image_edit

Create image edit

An MCP tool from the OpenAI API server, hosted on mcp.hjlabs.in.

Create image edit Creates an edited or extended image given one or more source images and a prompt. This endpoint supports GPT Image models. [POST /images/edits]

Name on the gateway: openai_api__create_image_edit · may change things.

Parameters

NameTypeDescription
frame_countintegerNumber of frames for GIF output. Accepts integers from 2 through 16. Defaults…
frame_duration_msintegerRequested delay per GIF frame, in milliseconds. Defaults to 200 when omitted.…
complexitystringComputation spent planning the image, independently of rendering quality. Uses…
modelstringThe GPT image model to use for image editing, including gpt-image-2, its dated…
images requiredarrayInput image references to edit. For GPT image models, you can provide up to 16…
maskobjectReference an input image by either URL or uploaded file ID. Provide exactly…
markupobjectA transparent PNG overlaid on the first image, referenced by file ID, HTTPS…
prompt requiredstringA text description of the desired image edit.
nintegerThe number of edited images to generate.
qualitylow | medium | high | xhigh | max | autoOutput quality for GPT image models. The GPT image models support low, medium…
input_fidelityhigh | lowControl how much effort the model will exert to match the style and features…
sizestringThe size of the generated images. For gpt-image-2, gpt-image-2-2026-04-21…
safety_identifierstringA stable identifier for an end user in your organization, used for safety…
userstringDeprecated: use safety_identifier instead. This parameter remains accepted for…
output_formatpng | jpeg | webp | gifOutput image format. Supported for GPT image models.
output_compressionintegerCompression level for jpeg or webp output.
moderationlow | autoModeration level for GPT image models.
backgroundtransparent | opaque | autoSet the background of the generated image output. gpt-image-2.5-sunburst and…
streambooleanStream partial image results as events.
partial_imagesintegerThe number of partial images to generate. This parameter is used for streaming…

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "openai_api__create_image_edit",
  "arguments": {
    "images": [],
    "prompt": "…"
  }
}

Or connect the OpenAI API server directly, which lists 371 tools including this one:

Run in your terminal
claude mcp add --transport http hj-openai-api https://mcp.hjlabs.in/mcp/openai-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the create image edit tool with frame_count set to ….

More from OpenAI API