Saltar al contenido principal
POST
Crear una edición de imagen

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Cuerpo

multipart/form-data
model
string
requerido
image
requerido
prompt
string
requerido
models
string[]

Modelos de respaldo opcionales y ordenados que se prueban después de model. model es obligatorio y siempre es el modelo principal. Cuando un intento falla con 429, 500, 502, 503 o 504, se prueba la siguiente entrada; los demás errores se devuelven sin cambios. Acepta hasta 25 IDs de modelo o presets; se ignoran los duplicados y las entradas iguales a model. Cada intento se valida, registra y factura como una solicitud independiente, y el campo model de la respuesta y la traza de enrutamiento muestran el modelo que atendió la solicitud. Las solicitudes en streaming solo recurren a un respaldo antes del primer byte, y los trabajos de video y música solo al enviarse. Las solicitudes de batch, realtime y council rechazan models. Los respaldos definidos en una ruta dinámica tienen prioridad, y phaseo/auto no se puede combinar con models.

Required array length: 1 - 25 elements
Minimum string length: 1
Ejemplo:
mask
string
markup
string

Capa de anotación PNG transparente sobre la primera imagen, como archivo subido, URL o cadena base64. Requiere GPT Image 2.5 o posterior y no se puede combinar con mask.

complexity
enum<string>
Opciones disponibles:
low,
medium,
high
size
string
resolution
string
n
integer
Rango requerido: 1 <= x <= 10
quality
enum<string>

Calidad de renderizado de imágenes. xhigh y max solo están disponibles para los modelos GPT Image 2.5.

Opciones disponibles:
standard,
low,
medium,
high,
xhigh,
max,
auto
stream
boolean
partial_images
integer
Rango requerido: 0 <= x <= 3
output_format
enum<string>
Opciones disponibles:
png,
jpeg,
webp
output_compression
integer
Rango requerido: 0 <= x <= 100
background
enum<string>
Opciones disponibles:
transparent,
opaque,
auto
moderation
enum<string>
Opciones disponibles:
auto,
low
input_fidelity
enum<string>
Opciones disponibles:
high,
low
user
string
meta
boolean
usage
boolean
provider
object

Preferencias de enrutamiento de proveedores para la selección de la pasarela.

Respuesta

Respuesta de edición de imagen

created
integer
data
object[]
Última modificación el 16 de noviembre de 2026