OpenAI

GPT Image 2.6

gpt-image-2.6-sunburst/text-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/text-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/text-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
svg · 1K	~~$0.053~~ $0.0424	~~$0.071~~ $0.0568	~~$0.079~~ $0.0632	~~$0.117~~ $0.0936	~~$0.225~~ $0.180
svg · 2K	~~$0.072~~ $0.0576	~~$0.105~~ $0.084	~~$0.120~~ $0.096	~~$0.190~~ $0.152	~~$0.390~~ $0.312
svg · 4K	~~$0.105~~ $0.084	~~$0.163~~ $0.1304	~~$0.190~~ $0.152	~~$0.313~~ $0.2504	~~$0.666~~ $0.5328
gif · 1K · 2K · 4K	~~$0.070~~ $0.056	~~$0.124~~ $0.0992	~~$0.150~~ $0.120	~~$0.266~~ $0.2128	~~$0.598~~ $0.4784

Descripción general

gpt-image-2.6-sunburst es la línea de texto a imagen de la familia de modelos de generación de imágenes de OpenAI, orientada a desarrolladores que necesitan producir imágenes por lotes mediante la interfaz unificada de HiAPI.ai. Admite la generación directa de imágenes a partir de indicaciones de texto, y sus formatos de salida abarcan mapas de bits habituales, así como SVG vectorial y GIF animado, y permite controlar las especificaciones del resultado mediante parámetros como calidad, resolución y relación de aspecto. Sunburst, en particular, mantiene mejor la coherencia de los detalles de la imagen al realizar múltiples iteraciones con una calidad de renderizado medium o superior, lo que lo hace adecuado para flujos de trabajo de contenido visual que requieren producción continua y ajustes repetidos.

Aspectos destacados

Mayor estabilidad de los detalles entre rondas: al generar o ajustar en varias rondas con calidad de renderizado medium o high, Sunburst mantiene mejor la coherencia de los detalles de la imagen.
Formatos de salida ampliados a vectorial y animación: la generación de texto a imagen puede producir directamente archivos SVG vectoriales y animaciones GIF, lo que reduce el paso de conversión de formato fuera de la interfaz.
Calidad de generación y de planificación ajustables por separado: quality controla la precisión del renderizado y complexity controla de forma independiente el nivel de planificación, por lo que se pueden aumentar por separado para texto denso y maquetaciones complejas.
Relaciones de aspecto que cubren formatos comerciales habituales: aspect_ratio ofrece múltiples proporciones, desde 1:1 hasta 21:9, 3:1 y otras, para obtener de una vez el tamaño correspondiente a cada canal de difusión.

Descripción de capacidades

Generación de imágenes a partir de texto: basta con introducir una indicación de hasta 32000 caracteres para generar una imagen; la salida predeterminada es png, lo que resulta adecuado para la generación por lotes mediante scripts.

Control por capas de la calidad de renderizado y de la planificación: quality ofrece cinco niveles de precisión de renderizado, de low a max, y complexity controla de forma independiente el nivel de planificación, de modo que en maquetaciones complejas se puede aumentar solo la planificación sin elevar por completo el nivel de renderizado.

Configuración de resolución y relación de aspecto: la resolución puede elegirse entre tres niveles (1K, 2K y 4K) y, junto con las múltiples relaciones de aspecto, genera directamente el tamaño final que se ajusta al formato deseado.

Salida multiformato y compresión: se puede elegir png, jpeg, webp, gif y svg; jpeg y webp admiten un nivel de compresión de 0 a 100, lo que facilita el equilibrio entre calidad de imagen y tamaño.

Fondo transparente y animación GIF: cuando background se establece en transparent, la salida se limita a png o webp; para GIF se pueden definir el número de fotogramas, el tamaño de fotograma y el intervalo entre fotogramas, y la tasa de fotogramas y el formato vienen determinados directamente por los parámetros.

Casos de uso

Generación rápida de bocetos creativos para equipos de diseño: generar varias versiones de bocetos con indicaciones breves, filtrarlas por nivel de calidad y relación de aspecto y después refinarlas, para comparar propuestas en la fase conceptual.
Producción continua de activos visuales de marca en serie: generar de forma repetida en torno a un mismo tema, con detalles más estables en calidad media y alta, y resultados directamente utilizables en materiales que requieren un estilo uniforme, como el sitio web oficial o las páginas de producto.
Materiales para redes sociales y campañas de equipos de marketing: generar imágenes por lotes en proporciones como 1:1, 9:16 y 16:9 y, tras comprimirlas, usarlas en publicaciones en redes sociales y páginas de destino de campañas.
Generación de material vectorial y animado para desarrolladores: elegir la salida svg o gif para obtener directamente gráficos vectoriales o animaciones fotograma a fotograma, destinados a iconos, ilustraciones y animaciones ligeras.

Limitaciones y recomendaciones de selección

Esta línea solo admite la generación de imágenes a partir de texto; si se necesita modificar localmente una imagen existente como entrada, debe utilizarse la línea image-to-image. La ventaja de coherencia entre rondas de Sunburst presupone una calidad de renderizado medium o high, por lo que no cabe esperar la misma estabilidad en los niveles de calidad baja. La salida GIF no admite el parámetro de relación de aspecto, y el tamaño de fotograma debe especificarse en píxeles y respetar el límite máximo de fotogramas; el fondo transparente solo es compatible con png y webp. En escenarios con requisitos estrictos de velocidad de generación y que no necesiten detalles estables, puede evaluarse la línea Flare 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/text-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

promptstringObligatoriominLength 1maxLength 32000

Describe la imagen que se va a generar; 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

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 imágenes simples con un único sujeto, high es adecuado para texto denso y diseños complejos; si no se especifica, es high.

Opciones:lowmediumhigh

frame_sizestringOpcionalpattern ^(auto|[0-9]+x[0-9]+)$

Solo para GIF: ancho x alto en píxeles de cada fotograma, por ejemplo 512x512; el ancho y el alto determinan también la proporción del GIF. Ambos lados deben ser múltiplos de 16; no se aceptan notaciones de proporción como 1:1; si no se especifica o se pasa auto, es 512x512. Todos los fotogramas se combinan en una sola imagen completa; cada lado de la imagen completa no debe superar 3840, el total de píxeles no debe superar 8.294.400 y la relación de aspecto no debe superar 3:1; si se excede, se rechaza en la fase de envío y no se cobra. 512x512 admite de 2 a 16 fotogramas; 768x768 admite como máximo 12 fotogramas.

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

frame_countintegerOpcionalPredeterminado: 9min 2max 16

Solo para GIF: número de fotogramas, entero de 2 a 16; si no se especifica, es 9. Con un tamaño de fotograma de 768x768 se admite un máximo de 12 fotogramas.

aspect_ratiostringOpcionalPredeterminado: "auto"

Relación de aspecto de salida; si no se especifica, es auto. GIF no usa este parámetro: si no se especifica o se pasa auto, se usa frame_size para controlar el tamaño y la proporción de cada fotograma.

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, gif, svg; si no se especifica, es png. gif genera imágenes animadas y svg genera archivos vectoriales; estos dos solo admiten texto a imagen. Si se pasa output_compression, se debe pasar también jpeg o webp; si se pasa cualquiera de frame_size, frame_count o frame_duration_ms, se debe pasar gif.

Opciones:pngjpegwebpgifsvg

frame_duration_msintegerOpcionalPredeterminado: 200min 20

Solo para GIF: duración de visualización de cada fotograma, en milisegundos, mínimo 20, redondeada a múltiplos de 10 milisegundos; si no se especifica, es 200.

output_compressionintegerOpcionalmin 0max 100

Nivel de compresión de 0 a 100, solo para jpeg o webp; al pasar este parámetro se debe establecer 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/text-to-image",
  "input": {
    "prompt": "…",
    "quality": "high",
    "resolution": "1K",
    "frame_count": 9,
    "aspect_ratio": "auto",
    "output_format": "png",
    "frame_duration_ms": 200
  }
}'

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/text-to-image",
    input: {
      "prompt": "…",
      "quality": "high",
      "resolution": "1K",
      "frame_count": 9,
      "aspect_ratio": "auto",
      "output_format": "png",
      "frame_duration_ms": 200
    }
  }),
});
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/text-to-image",
        "input": {
          "prompt": "…",
          "quality": "high",
          "resolution": "1K",
          "frame_count": 9,
          "aspect_ratio": "auto",
          "output_format": "png",
          "frame_duration_ms": 200
        }
    },
)
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"
    }
  }
}