OpenAI

GPT Image 2.6

gpt-image-2.6-sunburst/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-sunburst/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-sunburst/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

gpt-image-2.6-sunburst/image-to-image es un modelo orientado a la edición de imagen a imagen: recibe una o varias imágenes de origen junto con una descripción de la edición y genera la imagen modificada. Su punto fuerte es mantener la coherencia de los detalles a lo largo de varias rondas de edición: al ajustar repetidamente un mismo personaje, producto o diseño, los detalles de la imagen se mantienen más estables, lo que lo hace adecuado para la producción de activos visuales que requieren iteración continua. Los desarrolladores pueden invocarlo mediante la interfaz unificada de HiAPI.ai, con facturación por imagen.

Puntos clave

Coherencia de detalles en múltiples rondas de edición: con los niveles de calidad medium o high, mantiene la coherencia de los detalles del personaje, el producto y el diseño entre rondas de edición, ideal para ajustes finos repetidos.
Edición local mediante anotaciones: se puede enviar una capa superpuesta transparente con selecciones o anotaciones como indicación de modificación; las anotaciones no se conservan en la salida.
Composición de múltiples imágenes de origen y salida panorámica: permite pasar hasta 16 imágenes de origen a la vez, y ofrece relaciones de aspecto de 3:1 a 1:3 y niveles de resolución de 1K a 4K.

Capacidades

Edición de imágenes basada en imágenes de origen: toma de 1 a 16 imágenes de origen en jpeg, png o webp como entrada y redibuja o modifica la imagen según una descripción de edición de hasta 32000 caracteres; el tipo de salida es independiente de la imagen de origen y puede convertirse directamente al formato de entrega necesario.

Dos formas de localización: máscara y anotación: mask_url recibe un PNG RGBA del mismo tamaño que la primera imagen de origen, en el que los píxeles transparentes marcan la zona de edición; markup_url utiliza una capa superpuesta transparente como indicación de selección. Ambas opciones son mutuamente excluyentes.

Control por capas de calidad y planificación: quality controla el nivel de renderizado (de low a max) y complexity controla por separado la profundidad de planificación; con texto denso y diseños complejos se puede elevar el nivel de planificación sin aumentar necesariamente el coste de renderizado.

Formato de salida y tratamiento del fondo: se puede elegir salida en png, jpeg o webp; jpeg y webp admiten un nivel de compresión de 0 a 100; el fondo transparente solo está disponible en png o webp, ideal para materiales que se superpondrán directamente en páginas o diseños.

Resolución y relación de aspecto seleccionables: la resolución de salida puede ser 1K, 2K o 4K, y la relación de aspecto puede seguir automáticamente la imagen de origen o especificarse entre 16 preajustes, de 1:1 a 21:9, lo que facilita generar directamente el formato que coincida con el espacio objetivo.

Casos de uso

Equipos de diseño: iteración de series de personajes y productos: editar repetidamente una imagen de personaje existente con descripciones de modificación para producir activos visuales de serie con detalles estables, destinados a unificar materiales de marca e imágenes de producto.
Equipos de marketing: versiones masivas de materiales de campaña: usar el visual principal existente como imagen de origen y generar materiales para distintos espacios con diferentes relaciones de aspecto y resoluciones, listos para publicidad y redes sociales.
Desarrolladores: modificaciones locales guiadas por anotaciones: subir una capa superpuesta con selecciones para indicar la zona a modificar y obtener imágenes con correcciones locales, integrándolas en la cadena de producción de contenido para reducir el retrabajo manual.
Frontend y construcción de páginas: generación de imágenes transparentes: usar una imagen de referencia como origen y obtener png o webp con fondo transparente, listos para elementos de página y materiales de componentes.

Limitaciones y recomendaciones de elección

Las limitaciones se centran en el nivel de calidad y la forma de entrada: la ventaja de coherencia de detalles entre rondas solo se cumple con calidad medium o high, y no está garantizada en niveles de baja calidad; la máscara y la anotación no pueden usarse al mismo tiempo, y la máscara solo marca la zona de edición, por lo que la imagen completa aún puede redibujarse; el fondo transparente exige salida en png o webp, y los parámetros de compresión solo se aplican a jpeg y webp. Si la tarea consiste principalmente en generar directamente a partir de texto, sin restricciones de una imagen de origen, conviene usar la línea de texto a imagen 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-sunburst/image-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para gpt-image-2.6-sunburst/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 desea hacer a la imagen de origen, o la escena que se desea 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 especifica, es high.

Opciones:lowmediumhighxhighmax

mask_urlstringOpcional

URL de la imagen de máscara: PNG RGBA del mismo tamaño que la primera imagen de origen; los píxeles totalmente transparentes marcan la región que se desea modificar, aunque toda la imagen aún podría 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 es adecuado para texto denso y maquetaciones complejas; si no se especifica, es high.

Opciones:lowmediumhigh

image_urlsarrayObligatoriominItems 1maxItems 16

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

Array [ string ]

markup_urlstringOpcional

URL de la imagen de anotación: capa superpuesta PNG transparente que señala con círculos u otras marcas las posiciones que se desean 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 especifica, es low.

Opciones:autolow

resolutionstringOpcionalPredeterminado: "1K"

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

Opciones:1K2K4K

aspect_ratiostringOpcionalPredeterminado: "auto"

Relación de aspecto de salida; si no se especifica, 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 especifica, es png. Si se envía output_compression, debe enviarse también jpeg o webp.

Opciones:pngjpegwebp

output_compressionintegerOpcionalmin 0max 100

Nivel de compresión de 0 a 100, solo se usa para jpeg o webp; al enviar este parámetro, debe establecerse también 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-sunburst/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-sunburst/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-sunburst/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"
    }
  }
}