Skip to Content
ModelosGPT ImageEditar y combinar imágenes

Editar y combinar imágenes

Suba una o varias imágenes y modifíquelas o fusiónelas mediante una instrucción.

¿No va a escribir código? Consulte Generar imágenes en sus propias herramientas.

POST/v1/images/editsParámetros comunes

Antes de empezar

NecesitaDetalles
Clave de APICree una en la consola de OfoxAI  y sustituya YOUR_OFOX_API_KEY en el código
EntornocURL necesita jq para decodificar la imagen; Python necesita pip install openai; Node.js 18 o posterior, sin dependencias
ImágenesColoque un input.png en el directorio actual; para combinar imágenes, añada también un input2.png. PNG o JPEG, ≤ 15 MB cada una
Tiempo de esperaConfigure el tiempo de espera del cliente en 600 segundos. La alta calidad, los tamaños grandes o la edición pueden tardar varios minutos
Valores utilizados en el código
URL de la APIhttps://api.ofox.ai/v1
ID de modeloopenai/gpt-image-2.5-sunburstLos ejemplos usan flare; para la edición se recomienda sunburst
Clave de APISustituya YOUR_OFOX_API_KEY en el código por su clave
Dependencias de Pythonpip install openai

Editar una imagen

Todos los ejemplos siguientes se han ejecutado tal cual. El resultado se guarda como output.png en el directorio actual.

Terminal
curl -s https://api.ofox.ai/v1/images/edits \ -H "Authorization: Bearer YOUR_OFOX_API_KEY" \ -F "model=openai/gpt-image-2.5-flare" \ -F "image=@input.png" \ -F "prompt=Replace the background with a wooden table, keep the subject unchanged" \ -F "quality=low" \ -o response.json jq -r '.data[0].b64_json' response.json | base64 --decode > output.png

Si omite size, el modelo elige el tamaño de salida, que puede diferir del original. Para conservar el tamaño original, indíquelo explícitamente, p. ej. size=1024x1024.

Redactar la instrucción

Indique con claridad dos cosas: qué cambiar y qué conservar.

Caso de usoInstrucción de ejemplo
Editar una imagenSustituya el fondo por una mesa de madera y mantenga el sujeto sin cambios
Combinar imágenesColoque el sujeto de la primera imagen sobre el fondo de la segunda imagen

Con varias imágenes, refiérase a ellas según el orden de subida como «la primera imagen» y «la segunda imagen». Para cambiar solo una pequeña parte de la imagen, el Inpainting es más fiable.

Combinar varias imágenes

Envíe varias imágenes de referencia a la vez. El orden de subida determina a qué se refieren «la primera imagen» y «la segunda imagen» en su instrucción. Coloque input.png e input2.png en el directorio actual.

Terminal
# Up to 16 images per request, ≤ 15 MB each curl -s https://api.ofox.ai/v1/images/edits \ -H "Authorization: Bearer YOUR_OFOX_API_KEY" \ -F "model=openai/gpt-image-2.5-flare" \ -F "image[]=@input.png" \ -F "image[]=@input2.png" \ -F "prompt=Place the subject of the first image onto the background of the second" \ -F "quality=low" \ -o response.json jq -r '.data[0].b64_json' response.json | base64 --decode > output.png

Proveedores

No es necesario fijar un proveedor. Para los tres modelos, tanto Azure como OpenAI ofrecen el endpoint de edición, y el gateway enruta las peticiones automáticamente.

Si tiene requisitos de moderación de contenido, puede seleccionar un proveedor, pero el endpoint de edición solo acepta la cabecera X-OfoxAI-Provider-Type; extra_body en el formulario se ignora. Una vez seleccionado un proveedor, las peticiones no se redirigen a otro proveedor si este no está disponible. Consulte Seleccionar un proveedor.

Valores de los parámetros

Parámetros específicos del endpoint de edición. model, n, output_format y los demás funcionan igual que en texto a imagen — consulte Texto a imagen · Valores de los parámetros.

Obligatorios
imageobligatoriofileform

La imagen que se va a editar. Para varias imágenes, repita el campo como image[]; con el SDK de Python, pase una lista.

▸ Detalles

Las imágenes de referencia también se facturan como tokens: una imagen de referencia de 1024×1024 midió 1.024 tokens de entrada, por lo que la edición cuesta más que texto a imagen con el mismo tamaño.

▶Avanzados · 1X-OfoxAI-Provider-TypeExpand
X-OfoxAI-Provider-Typestringheader· valoresazure_foundryopenai

Normalmente no es necesario: el gateway enruta automáticamente. Utilícelo solo para fijar un proveedor concreto.

Límites de subida

ElementoLímite
Cada imagen de referencia≤ 15 MB
Petición completa≤ 50 MB
Número de imágenesSin límite en el gateway; manténgalo en 16 o menos
FormatoPNG, JPEG

El modelo reescala las imágenes de referencia a unos 1024 px. Los archivos de más de 5 MB solo hacen la subida más lenta; no mejoran el resultado.

Errores habituales

ErrorCausaSolución
Invalid image file or modeLa imagen subida no es un PNG o JPEG estándarVuelva a exportarla como PNG o JPEG
Invalid file 'image[0]': unsupported mimetypeEl archivo subido no es una imagenSuba una imagen PNG, JPEG o WebP
does not support the 'input_fidelity' parameterSe envió input_fidelityElimínelo; esta familia procesa siempre las imágenes de referencia con alta fidelidad
moderation_blockedLa instrucción o la imagen de referencia fue bloqueada por el sistema de seguridad del proveedor de origenModifique la instrucción o la imagen de referencia y vuelva a intentarlo
provider_type_unavailableEl proveedor fijado manualmente no ofrece este modeloElimine la cabecera X-OfoxAI-Provider-Type
Invalid sizeEl tamaño indicado incumple una de las cuatro reglasConsulte Tamaño
404 model_not_foundID de modelo mal escrito o con mayúsculas incorrectasCopie el ID de modelo de esta página

Para otros errores, consulte la tabla completa de errores.

Documentación oficial

La documentación de OpenAI describe el comportamiento al llamar directamente a OpenAI. Cuando llama a través de OfoxAI, prevalecen los resultados medidos en estas páginas. Por ejemplo, no es necesario fijar un proveedor para la edición.

Last updated on