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

Necesita	Detalles
Clave de API	Cree una en la consola de OfoxAI y sustituya `YOUR_OFOX_API_KEY` en el código
Entorno	cURL necesita `jq` para decodificar la imagen; Python necesita `pip install openai`; Node.js 18 o posterior, sin dependencias
Imágenes	Coloque 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 espera	Configure 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.io/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.

cURL

Terminal


curl -s https://api.ofox.io/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

Python

edit.py


import base64
from openai import OpenAI
 
client = OpenAI(
    api_key="YOUR_OFOX_API_KEY",  # replace with your key
    base_url="https://api.ofox.io/v1",
)
 
result = client.images.edit(
    model="openai/gpt-image-2.5-flare",
    image=open("input.png", "rb"),
    prompt="Replace the background with a wooden table, keep the subject unchanged",
    quality="low",
)
 
with open("output.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))
print("Saved output.png")

Node.js

edit.mjs


// Node.js 18+, no dependencies to install
import { readFileSync, writeFileSync } from "node:fs";
 
const form = new FormData();
form.append("model", "openai/gpt-image-2.5-flare");
form.append("image", new Blob([readFileSync("input.png")], { type: "image/png" }), "input.png");
form.append("prompt", "Replace the background with a wooden table, keep the subject unchanged");
form.append("quality", "low");
 
const res = await fetch("https://api.ofox.io/v1/images/edits", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_OFOX_API_KEY", // replace with your key
  },
  body: form,
});
 
const json = await res.json();
if (!res.ok) throw new Error(JSON.stringify(json));
writeFileSync("output.png", Buffer.from(json.data[0].b64_json, "base64"));
console.log("Saved 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 uso	Instrucción de ejemplo
Editar una imagen	Sustituya el fondo por una mesa de madera y mantenga el sujeto sin cambios
Combinar imágenes	Coloque 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.

cURL

Terminal


# Up to 16 images per request, ≤ 15 MB each
curl -s https://api.ofox.io/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

Elemento	Límite
Cada imagen de referencia	≤ 15 MB
Petición completa	≤ 50 MB
Número de imágenes	Sin límite en el gateway; manténgalo en 16 o menos
Formato	PNG, 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

Error	Causa	Solución
`Invalid image file or mode`	La imagen subida no es un PNG o JPEG estándar	Vuelva a exportarla como PNG o JPEG
`Invalid file 'image[0]': unsupported mimetype`	El archivo subido no es una imagen	Suba una imagen PNG, JPEG o WebP
`does not support the 'input_fidelity' parameter`	Se envió `input_fidelity`	Elimínelo; esta familia procesa siempre las imágenes de referencia con alta fidelidad
`moderation_blocked`	La instrucción o la imagen de referencia fue bloqueada por el sistema de seguridad del proveedor de origen	Modifique la instrucción o la imagen de referencia y vuelva a intentarlo
`provider_type_unavailable`	El proveedor fijado manualmente no ofrece este modelo	Elimine la cabecera `X-OfoxAI-Provider-Type`
`Invalid size`	El tamaño indicado incumple una de las cuatro reglas	Consulte Tamaño
`404 model_not_found`	ID de modelo mal escrito o con mayúsculas incorrectas	Copie 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.