API de edición de imágenes y referencias de GPT Image 2.5 Sunburst en E2X
GPT Image 2.5 Sunburst edit-image es el endpoint de edición condicionada por referencias de OpenAI en E2X, disponible en openai/gpt-image-2.5-sunburst/edit-image. Envía una o varias URLs de origen en image_urls junto con una instrucción de hasta 50,000 caracteres, y el modelo modificará la imagen existente, compondrá múltiples productos en una sola escena o sustituirá textos integrados. Con nuestro descuento permanente del 75%, una edición en 1K se factura a $0.0525 por imagen generada tanto si eliges calidad low, medium, high, xhigh o max, situándose un 75% por debajo de la referencia de nivel alto de $0.211 en fal.ai.
¿Vas a generar únicamente a partir de una descripción escrita sin fotos de referencia? Llama entonces a GPT Image 2.5 Sunburst text-to-image, que aplica la misma tabla de tarifas y solo requiere prompt. GPT Image 2.5 Sunburst admite los 5 niveles de calidad (low, medium, high, xhigh, max) en 1K, 2K y 4K, mientras que GPT Image 2.5 Flare (edit-image) cubre los flujos de trabajo estándar de 3 niveles (low, medium, high).
Precios por edición según resolución y nivel de calidad
Cada solicitud de edición en openai/gpt-image-2.5-sunburst/edit-image comienza con una tarifa base de lista de $0.03 (30,000 microcéntimos) que nuestro descuento global del 75% reduce a $0.0075 (7,500 microcéntimos) antes de aplicar dos coeficientes de parámetros:
- Factor de
resolution: 1K (predeterminado) = ×1, 2K = ×2, 4K = ×3.
- Factor de
quality: low, medium, high (predeterminado), xhigh y max aplican cada uno un coeficiente de ×7.
Dado que las cinco opciones de quality multiplican por 7 la base con descuento de $0.0075 ($0.0075 × 7 = $0.0525 en 1K), resolution es la única variable que modifica el precio. Puedes ejecutar calidad high, xhigh o max exactamente por el mismo precio que low. Además, a diferencia de nuestra ruta anterior GPT Image 2 edit-image, donde quality era un campo obligatorio, en GPT Image 2.5 Sunburst quality es opcional y toma high por defecto.
Matriz completa de tarifas por edición verificada el 4 de noviembre de 2026:
| Resolución de salida | Tarifa E2X con descuento | Tarifa de lista sin dto. | Factor combinado | Equivalente en fal.ai | Fase de edición habitual |
|---|
1K (por defecto en esquema) | $0.0525 | $0.21 | 1 × 7 | $0.211 (75% más caro) | Ajuste de prompts, pruebas de texto en etiquetas, cambios de fondo |
2K | $0.1050 | $0.42 | 2 × 7 | $0.222 (53% más caro) | Packshots de comercio electrónico en producción y banners web principales |
4K | $0.1575 | $0.63 | 3 × 7 | $0.401 (61% más caro) | Composiciones listas para imprenta y exportaciones maestras en alta resolución |
Esa estructura de precios simplifica el presupuesto de un ciclo de edición. Cuando estés ajustando un prompt para reemplazar el texto de la etiqueta de una botella o probando tres entornos de iluminación distintos para el recorte de un producto, mantén resolution en 1K ($0.0525 cada una) mientras ejecutas calidad high o xhigh. Cinco ediciones exploratorias en 1K más una exportación final en 2K ($0.105) suman $0.3675 en total.
Los precios y las condiciones del producto pueden cambiar. Consulta las tarifas vigentes de cada proveedor antes de tomar una decisión de compra. Los precios de Google Batch o Flex no equivalen directamente a una solicitud de API estándar bajo demanda, ya que difieren las condiciones de programación, disponibilidad y procesamiento; por tanto, quedan excluidos de esta comparativa. Esta es una comparación acotada, no una afirmación de que E2X sea la opción más barata del mercado en cualquier configuración.
Flujos de trabajo de edición principales para este endpoint
- Localización y reemplazo de texto dentro de la imagen: Pasa al endpoint un cartel terminado, el diseño plano de un envase o una tarjeta de interfaz y especifica entre comillas dobles la cadena exacta de sustitución. El modelo actualiza las palabras manteniendo intactos el diseño circundante, la perspectiva y el sombreado de la superficie.
- Composición de escenas con múltiples referencias: Proporciona un array de URLs de origen en
image_urls para combinar elementos separados en un mismo encuadre, como colocar el recorte de un producto de la imagen 1 sobre la mesa de estudio mostrada en la imagen 2 bajo la paleta de colores de la imagen 3.
- Cambios específicos de atributos y rediseño de estilo: Mantén fija la geometría del sujeto mientras cambias materiales, vestuario, hora del día o escenario de fondo mediante un prompt diferencial.
- Límite ampliado de prompt de 50,000 caracteres: Mientras que la versión de texto a imagen limita los prompts a 32,000 caracteres,
edit-image acepta hasta 50,000 caracteres, ofreciendo a los pipelines automatizados espacio de sobra para enviar especificaciones detalladas de maquetación, reglas de estilo de marca e instrucciones por imagen de referencia.
Solicitud a la API: envío de URLs de origen y sondeo
prompt e image_urls son los dos parámetros obligatorios en openai/gpt-image-2.5-sunburst/edit-image. aspect_ratio (por defecto 1:1), resolution (por defecto 1K) y quality (por defecto high) son opcionales.
Aquí tienes una llamada con curl que envía la edición de la etiqueta de un envase con calidad xhigh y resolución 2K ($0.105):
curl -X POST https://api.e2x.ai/v1/jobs/submit \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-image-2.5-sunburst/edit-image",
"input": {
"prompt": "Change the main label title on the amber glass jar to \"BERGAMOT & CEDAR SOY CANDLE\" in the same serif font and gold foil finish. Keep the apothecary jar shape, wooden lid, and linen backdrop unchanged.",
"image_urls": [
"https://example.com/assets/amber-jar-original.png"
],
"aspect_ratio": "4:5",
"resolution": "2K",
"quality": "xhigh"
}
}'
A continuación se muestra un ejemplo completo en Node.js que compone dos imágenes de referencia en 1K ($0.0525) y sondea el trabajo hasta que termina:
const headers = {
Authorization: `Bearer ${process.env.E2X_API_KEY}`,
"Content-Type": "application/json",
};
const createJob = await fetch("https://api.e2x.ai/v1/jobs/submit", {
method: "POST",
headers,
body: JSON.stringify({
model: "openai/gpt-image-2.5-sunburst/edit-image",
input: {
prompt: "Place the titanium chronograph watch from image 1 onto the wet slate block in image 2. Match the cool side-lighting from image 2 and keep the sub-dial numerals sharp.",
image_urls: [
"https://example.com/assets/chronograph-front.png",
"https://example.com/assets/wet-slate-surface.jpg",
],
aspect_ratio: "1:1",
resolution: "1K",
quality: "max",
},
}),
}).then((res) => res.json());
const jobId = createJob.data.jobId;
while (true) {
await new Promise((r) => setTimeout(r, 3000));
const statusPayload = await fetch(`https://api.e2x.ai/v1/jobs/${jobId}`, {
headers,
}).then((res) => res.json());
const state = statusPayload.data.status;
if (state === "completed") {
console.log("Edited output URL:", statusPayload.data.outputs[0].url);
break;
}
if (state === "failed" || state === "cancelled") {
throw new Error(statusPayload.data.error?.message || `Edit job ${state}`);
}
}
Cada URL incluida en image_urls debe ser accesible públicamente mediante HTTPS para que nuestros workers puedan descargar el archivo de origen. Puedes revisar la definición completa de parámetros en la especificación del endpoint legible por máquina o integrarlo mediante nuestros SDKs oficiales.
Comparativa de endpoints de edición de imágenes en E2X
Elige entre nuestros seis endpoints de imagen a imagen según si tu edición se centra en tipografía, recortes transparentes, identidad facial o costes en grandes volúmenes:
| Modelo de edición | Precio 1K | Precio 4K | Resolución máx. | Ventaja principal |
|---|
| GPT Image 2.5 Sunburst edit | $0.0525 | $0.1575 | 4K | Prompts de 50,000 caracteres, niveles de calidad xhigh y max sin coste extra, proporción auto |
| GPT Image 2 edit | $0.0525 | $0.1575 | 4K | Admite background: "transparent" para recortes PNG con canal alfa al mismo precio |
| Nano Banana 2.1 edit | $0.0300 | $0.0900 | 4K | Precio de edición 4K más bajo ($0.09) y 15 proporciones hasta 8:1 |
| Nano Banana Pro edit | $0.0750 | $0.1500 | 4K | Mejor retención de identidad facial con múltiples referencias de personajes |
| Nano Banana 2 edit | $0.0400 | $0.0800 | 4K | Cambios rápidos de fondo y ajustes de color para uso diario |
| Nano Banana 2 Lite edit | $0.0238 | n/a | 1K | Menor coste fijo de edición en 1K para pipelines de catálogos masivos |
Cuando una edición requiera un fondo PNG transparente (background: "transparent"), utiliza GPT Image 2 edit-image a la misma tarifa de $0.0525 (1K), ya que gpt-image-2.5-sunburst/edit-image no expone el campo background. Cuando necesites ediciones en 4K económicas a escala ($0.09) o banners ultraanchos 8:1, utiliza Nano Banana 2.1 edit-image. Explora todos los modelos de edición en la categoría de imagen a imagen o en el catálogo completo de modelos.
Cómo escribir prompts de edición eficaces
Un prompt de edición funciona mejor cuando describe el cambio en lugar de volver a describir toda la imagen de origen desde cero:
- Indica qué cambia y qué permanece fijo: Especifica claramente qué elementos deben quedar intactos ("sustituye el tablero de madera por mármol de Carrara apomazado; mantén sin cambios la taza de cerámica, el vapor y el ángulo del asa").
- Numera con claridad las imágenes de referencia múltiples: Al pasar dos o más URLs en
image_urls, haz referencia a ellas por su posición ("toma la zapatilla de la imagen 1, colócala sobre la calle de asfalto mojado de la imagen 2 e iguala los reflejos de neón de la imagen 3").
- Cita literalmente el texto de reemplazo: Escribe el texto exacto de sustitución entre comillas dobles e indica cómo debe relacionarse con la tipografía existente ("sustituye el texto de la insignia por "LIMITED EDITION 250ML" en la misma fuente sans-serif condensada").
- Ajusta la relación de aspecto al origen o usa
auto: Configurar aspect_ratio: "auto" permite al modelo conservar el encuadre de tu imagen de entrada, mientras que especificar 16:9 o 9:16 le indica que reencuadre o amplíe la escena para adaptarla al nuevo lienzo.
Para ver más ejemplos de flujos de trabajo basados en referencias, lee nuestra guía de generación consistente de imágenes y nuestra comparativa de modelos Nano Banana.
Preguntas frecuentes
¿Cuánto cuesta una edición individual con GPT Image 2.5 Sunburst en E2X?
Tras nuestro descuento del 75%, una edición se factura a $0.0525 en resolution: "1K" (el valor predeterminado), $0.105 en 2K y $0.1575 en 4K, tanto si quality se configura en low, medium, high, xhigh o max.
¿Qué parámetros son obligatorios en el endpoint edit-image?
Solo prompt (hasta 50,000 caracteres) e image_urls (un array con al menos una URL de imagen accesible públicamente) son obligatorios. aspect_ratio, resolution y quality son opcionales y toman por defecto los valores "1:1", "1K" y "high".
¿En qué se diferencia GPT Image 2.5 Sunburst edit-image de GPT Image 2 edit-image?
Ambos endpoints comparten la misma tabla de tarifas ($0.0525 para 1K, $0.105 para 2K y $0.1575 para 4K). En GPT Image 2.5 Sunburst, quality es opcional y añade los niveles xhigh y max sin coste adicional, y aspect_ratio añade "auto" además de las 15 proporciones fijas. Sin embargo, gpt-image-2.5-sunburst/edit-image no incluye el parámetro de transparencia background presente en gpt-image-2/edit-image.
¿Puedo enviar varias imágenes de referencia en una sola solicitud?
Sí. image_urls acepta un array de URLs de origen para que puedas combinar sujetos, fondos y referencias de estilo en un único trabajo. Haz referencia a cada imagen por su número en el prompt ("imagen 1", "imagen 2") para que el modelo sepa qué papel desempeña cada archivo.
¿Por qué el límite del prompt aquí es de 50,000 caracteres en lugar de 32,000?
Los pipelines de edición basados en referencias suelen inyectar restricciones estructuradas de diseño, transcripciones OCR de etiquetas existentes e instrucciones de condicionamiento por imagen. El tope de 50,000 caracteres permite alojar esas cargas automatizadas más extensas sin truncamiento.
¿Cómo mantengo bajos los costes de iteración al ajustar una edición?
Mantén resolution: "1K" mientras pruebas la redacción del prompt y la ubicación en la composición con calidad high, xhigh o max. Cada pasada en 1K cuesta $0.0525 en lugar de $0.105 (2K) o $0.1575 (4K). Sube resolution a 2K o 4K únicamente para la exportación final.
¿Cuándo conviene elegir Nano Banana Pro o Nano Banana 2.1 para editar?
Elige Nano Banana Pro ($0.075 en 1K) cuando la máxima prioridad sea conservar el parecido facial de una persona específica desde múltiples ángulos de referencia. Elige Nano Banana 2.1 ($0.03 para ediciones en 1K y $0.09 para ediciones en 4K) si necesitas la tarifa de edición 4K más baja en E2X o relaciones de aspecto extremas 8:1 y 1:8.