Editar gpt-image-2

POST

/v1/images/edits

• Editar o componer imágenes según prompt e imagen de referencia image (gpt-image-2)
• mask opcional para indicar zonas transparentes como área de edición
• Cuerpo de solicitud en multipart/form-data (con campos de imagen binarios)
• Documentación oficial: Images createEdit

Authorizations

bearer

Type

HTTP (bearer)

Request Body

multipart/form-data

object

Imagen a editar. Debe ser un archivo de imagen compatible o un array de imágenes. Para gpt-image-1, cada imagen debe ser png, webp o jpg menor de 25 MB. Para dall-e-2 solo una imagen cuadrada png menor de 4 MB.

Format"binary"

Descripción textual de la imagen deseada. Máximo 1000 caracteres para dall-e-2 y 32000 para gpt-image-1.

Imagen adicional cuyas zonas totalmente transparentes (p. ej. alfa cero) indican dónde editar image. Con varias imágenes, la máscara se aplica a la primera. PNG válido menor de 4 MB y mismas dimensiones que image.

Format"binary"

Modelo para generar la imagen. Solo gpt-image-1, gpt-image-1-all, flux-kontext-pro, flux-kontext-max.

Número de imágenes a generar. Entre 1 y 10.

Calidad de la imagen generada. Solo gpt-image-1 admite high, medium y low. dall-e-2 solo standard. Por defecto auto.

Formato de devolución de imágenes. url o b64_json. Las URL son válidas 60 minutos tras la generación. Solo aplica a dall-e-2; gpt-image-1 siempre devuelve base64 — no use este parámetro con gpt-image-1.

Tamaño de la imagen. Modelos GPT Image: 1024x1024, 1536x1024 (horizontal), 1024x1536 (vertical) o auto. dall-e-2: 256x256, 512x512 o 1024x1024. dall-e-3: 1024x1024, 1792x1024 o 1024x1792.

Transparencia del fondo de imágenes generadas. Solo gpt-image-1: transparent, opaque o auto. Con auto el modelo elige el mejor fondo.

Nivel de moderación de contenido para imágenes gpt-image-1. low para filtrado menos estricto, auto por defecto.

Responses

Content-Type

application/json

object

object[]

Required

object

Required