OpenAI

GPT Image 2.6

gpt-image-2.6-flare/image-to-image

Modelo de generación y edición de imágenes de OpenAI con dos niveles: Flare prioriza la velocidad y Sunburst busca la precisión; puede generar directamente GIF animados y gráficos vectoriales SVG, y admite edición localizada de imágenes

gpt-image-2.6-flare/image-to-image gpt-image-2.6-flare/text-to-image gpt-image-2.6-sunburst/image-to-image gpt-image-2.6-sunburst/text-to-image

Probar gpt-image-2.6-flare/image-to-image

Entrada

Salida

image

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

GPT Image 2.6: descuento por tiempo limitado del 20 % 20% OFF · Termina 2026-11-13 Ver oferta

gpt-image-2.6-flare/image-to-image per image

Especificaciones	low	medium	high	xhigh	max
1K	~~$0.023~~ $0.0184	~~$0.041~~ $0.0328	~~$0.049~~ $0.0392	~~$0.087~~ $0.0696	~~$0.195~~ $0.156
2K	~~$0.042~~ $0.0336	~~$0.075~~ $0.060	~~$0.090~~ $0.072	~~$0.160~~ $0.128	~~$0.360~~ $0.288
4K	~~$0.075~~ $0.060	~~$0.133~~ $0.1064	~~$0.160~~ $0.128	~~$0.283~~ $0.2264	~~$0.636~~ $0.5088

Descripción general

El modelo de imagen a imagen gpt-image-2.6-flare está orientado a desarrolladores que necesitan modificar, ampliar y recrear material existente. Toma una imagen de origen como entrada y un prompt como instrucción para realizar la edición, puede recibir hasta 16 imágenes de referencia en una sola llamada y admite repintado local mediante máscara, indicaciones con anotaciones y salida con resolución de 1K a 4K. Es adecuado para integrar la capacidad de edición de imágenes en flujos automatizados como producción de contenidos, material para comercio electrónico y generación de imágenes de marketing.

Puntos clave

Hasta 16 imágenes de origen en una sola llamada: varias imágenes de referencia pueden servir simultáneamente como base de la edición, lo que reduce las llamadas por lotes y el empalme de resultados.
Dos formas de control local: máscara y anotación: la máscara designa la región que se va a repintar; la imagen anotada sirve para delimitar la indicación y no se conserva en la salida. Ambas no pueden usarse al mismo tiempo.
Calidad y complejidad se ajustan por separado: la calidad de renderizado y la complejidad de planificación tienen niveles independientes, por lo que se pueden elegir según la dificultad de la tarea sin subir o bajar la configuración de forma conjunta.
Resolución y formato se pueden especificar según el objetivo de salida: admite 1K, 2K, 4K y varias relaciones de aspecto; también puede seguir la imagen de origen o dejar que el modelo lo decida automáticamente.

Descripción de capacidades

Edición por instrucciones basada en la imagen de origen: se describe la intención de la modificación mediante un prompt y se completa la edición con 1 a 16 imágenes de origen en jpeg, png o webp; es adecuado para transformar de forma dirigida una imagen existente en lugar de generar desde cero.

Repintado local con máscara: se pasa una máscara PNG RGBA del mismo tamaño que la primera imagen de origen, y los píxeles transparentes marcan la región que se va a editar; las zonas fuera de la máscara también pueden presentar cambios ligeros.

Indicación con anotaciones para localizar modificaciones: se usa un PNG transparente con anotaciones como círculos u otras marcas como indicación auxiliar para guiar al modelo hacia la región objetivo; la anotación en sí no aparece en la salida.

Control de formato de salida y fondo: se puede elegir salida en png, jpeg o webp; jpeg y webp admiten niveles de compresión de 0 a 100; cuando se necesita fondo transparente, el formato de salida se limita a png o webp.

Niveles de calidad, complejidad y moderación de contenido: la calidad de renderizado tiene cinco niveles y la complejidad de planificación tres, lo que permite adaptarse por separado a retoques precisos y a tareas con texto denso o maquetación compleja; la moderación de contenido puede ser automática o baja.

Casos de uso

Iteración múltiple de equipos de diseño sobre material existente: se introducen borradores visuales existentes e indicaciones de modificación, se ajustan composición y detalles ronda a ronda y se obtienen recursos de imagen listos para revisión.
Recreación de material para equipos de comercio electrónico y marca: se usan imágenes de producto o visuales principales como origen para sustituir fondos, ampliar escenas o corregir zonas, y se obtienen imágenes de producto y de campaña listas para publicar.
Flujos de composición y retoque local: se usa una máscara o una anotación para localizar la zona que se va a modificar, se ajusta solo la parte indicada y se generan gráficos para componer carteles, páginas de detalle y otras maquetaciones.
Necesidades de entrega en alta resolución: se especifican directamente la resolución 2K o 4K y la relación de aspecto objetivo, lo que reduce los pasos posteriores de ampliación y recorte.

Limitaciones y recomendaciones de selección

Este es un modelo de edición de imagen a imagen y no tiene capacidad de generar imágenes a partir de texto; para generar desde cero hay que usar la línea text-to-image de la misma familia. El control local depende de máscaras o anotaciones, y las zonas fuera de la máscara también pueden presentar cambios ligeros. La salida con fondo transparente está condicionada por el formato y debe combinarse con png o webp; los niveles de compresión solo se aplican a jpeg y webp. Cuando se necesita mantener la coherencia de detalles a lo largo de varias rondas de edición, se puede optar por la línea Sunburst de la misma familia.

Preguntas frecuentes

Ver todas las preguntas →

¿Cómo se factura? ¿Se cobra si se rechaza la solicitud?

La facturación es por imagen, y el precio unitario depende del nivel de calidad y la resolución; consulta la tabla de precios de esta página; Flare y Sunburst tienen el mismo precio. En el caso de imagen a imagen, se añaden $0.012 por cada imagen de referencia. El GIF se factura por separado según el nivel de calidad, independientemente de la resolución. Las solicitudes con parámetros no válidos o con un tamaño de GIF que supere el límite se rechazan en la fase de envío, y el importe preautorizado se reembolsa en su totalidad, sin cargo alguno.
¿Se puede modificar solo una parte de la imagen?

Sí, con la ruta de imagen a imagen, puedes elegir una de dos opciones. La primera es mask_url: envía un PNG RGBA del mismo tamaño que la primera imagen de origen; los píxeles completamente transparentes son la región que se va a modificar. La segunda es markup_url: envía una imagen PNG transparente con anotaciones, en la que indiques mediante círculos u otras marcas la ubicación que quieres cambiar; las anotaciones en sí no aparecerán en el resultado. No se pueden enviar ambas a la vez. Incluso usando una máscara, el modelo aún podría redibujar ligeramente toda la imagen.
¿Cuál es la diferencia entre Flare y Sunburst, y cuál debería elegir?

Ambos tienen parámetros, uso y precio idénticos; la diferencia está en el enfoque. Según la presentación de OpenAI, Flare genera imágenes más rápido, ideal para iteración rápida y generación por lotes, y es la opción predeterminada recomendada; Sunburst pone más énfasis en el detalle, y al realizar ediciones de múltiples rondas en niveles de calidad medium o superior, mantiene con mayor consistencia los detalles de personajes, productos o composición. En general, usa primero Flare; cuando necesites modificar repetidamente la misma imagen y requieras estabilidad en los detalles, cambia a Sunburst y ajusta quality a medium o superior.
¿Se pueden generar directamente GIF animados o SVG vectoriales?

Sí, en la ruta de texto a imagen basta con establecer output_format en gif o svg; la ruta de imagen a imagen solo admite png, jpeg, webp. El GIF se controla con tres parámetros: frame_size define el tamaño en píxeles de cada fotograma (por defecto 512x512, el ancho y el alto también determinan la proporción del GIF), frame_count define el número de fotogramas (2–16, por defecto 9), frame_duration_ms define la duración de cada fotograma (por defecto 200 milisegundos). Al generar un GIF, no se pasa aspect_ratio o se pasa auto.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: gpt-image-2.6-flare/image-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para gpt-image-2.6-flare/image-to-image y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 1maxLength 32000

Describe la modificación que se debe hacer a la imagen de origen, o la escena que se debe generar a partir de la imagen de origen; máximo 32000 caracteres.

qualitystringOpcionalPredeterminado: "high"

Nivel de calidad de renderizado; valores posibles: low, medium, high, xhigh, max; si no se envía, es high.

Opciones:lowmediumhighxhighmax

mask_urlstringOpcional

URL de la imagen de máscara: un PNG RGBA del mismo tamaño que la primera imagen de origen; los píxeles totalmente transparentes marcan la región que se debe modificar, aunque toda la imagen aún puede redibujarse ligeramente. No se puede enviar junto con markup_url.

backgroundstringOpcional

Modo de fondo; valores posibles: auto, opaque, transparent; transparent requiere que la salida sea png o webp.

Opciones:autoopaquetransparent

complexitystringOpcional

Nivel de planificación, independiente de la calidad de renderizado: low es adecuado para modificaciones locales y puntuales, high para texto denso y composiciones complejas; si no se envía, es high.

Opciones:lowmediumhigh

image_urlsarrayObligatoriominItems 1maxItems 16

Array de URL de imágenes de origen: de 1 a 16 imágenes http(s) de acceso público; admite jpeg, png, webp.

Array [ string ]

markup_urlstringOpcional

URL de la imagen de anotación: una capa PNG transparente que indica mediante círculos u otras marcas las ubicaciones que se deben modificar; las anotaciones no aparecen en el resultado. No se puede enviar junto con mask_url.

moderationstringOpcional

Nivel de moderación de contenido; valores posibles: auto o low; si no se envía, es low.

Opciones:autolow

resolutionstringOpcionalPredeterminado: "1K"

Nivel de resolución de salida; valores posibles: 1K, 2K, 4K; si no se envía, es 1K.

Opciones:1K2K4K

aspect_ratiostringOpcionalPredeterminado: "auto"

Relación de aspecto de salida; si no se envía, es auto, es decir, se mantiene la proporción de la imagen de origen.

Opciones:auto1:13:22:34:33:45:44:5

Mostrar todo (8)

16:99:162:11:221:99:213:11:3

output_formatstringOpcionalPredeterminado: "png"

Formato de salida; valores posibles: png, jpeg, webp; si no se envía, es png. Si se envía output_compression, también se debe enviar jpeg o webp.

Opciones:pngjpegwebp

output_compressionintegerOpcionalmin 0max 100

Nivel de compresión de 0 a 100, solo para jpeg o webp; al enviar este parámetro, también se debe establecer output_format en jpeg o webp.

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2.6-flare/image-to-image",
  "input": {
    "prompt": "…",
    "quality": "high",
    "image_urls": "…",
    "resolution": "1K",
    "aspect_ratio": "auto",
    "output_format": "png"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2.6-flare/image-to-image",
    input: {
      "prompt": "…",
      "quality": "high",
      "image_urls": "…",
      "resolution": "1K",
      "aspect_ratio": "auto",
      "output_format": "png"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "gpt-image-2.6-flare/image-to-image",
        "input": {
          "prompt": "…",
          "quality": "high",
          "image_urls": "…",
          "resolution": "1K",
          "aspect_ratio": "auto",
          "output_format": "png"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}