Skip to main content
API Reference: POST /images/edits

Provider capabilities

The table below summarizes gateway support for this endpoint by provider.
Legend:
  • Supported by Provider and Truefoundry
  • Provided by provider, but not by Truefoundry
  • Provider does not support this feature
For every gateway endpoint and provider, see Supported APIs. The Image Edit API lets you modify images using text instructions. You can edit specific parts of an image, add new elements, or extend the image beyond its original boundaries. Just provide your source image and describe what changes you want to make.

Supported Providers

  • OpenAI: Supports dall-e-2 and gpt-image-1 models
  • Vertex AI: Supports imagen-3.0-generate-001 model
  • AWS Bedrock: Supports amazon-nova-canvas model
  • Azure OpenAI: Supports gpt-image-1 model

Requirements

Example Usage

OpenAI supports both gpt-image-1 (up to 16 images, PNG/WebP/JPG, <50MB) and dall-e-2 (1 square PNG image, <4MB). The meaning of the parameters are present in the OpenAI API documentation.
gpt-image-1 supports up to 16 images in PNG, WebP, or JPG format with a 50MB size limit per image. dall-e-2 requires a single square PNG image under 4MB.
Vertex AI’s Imagen 3.0 model supports editing a single image in PNG or JPG format (max 20MB). The meaning of the parameters are present in the Google Vertex documentation.
Vertex AI supports a single image in PNG or JPG format with a maximum size of 20MB.
AWS Bedrock’s Nova Canvas model supports editing a single image in PNG or JPG format (max 5MB).
The meaning of the parameters are present in the AWS Bedrock documentation.
The meaning of the parameters are present in the AWS Bedrock documentation.
AWS Bedrock supports a single image in PNG or JPG format with a maximum size of 5MB.
Azure OpenAI’s gpt-image-1 model supports up to 16 images in PNG, WebP, or JPG format (max 50MB each). The meaning of the parameters are present in the Azure OpenAI documentation.
Azure OpenAI supports up to 16 images in PNG, WebP, or JPG format with a 50MB size limit per image.

Response Format

The API returns an ImagesResponse object containing: