OpenAI

GPT Image 2.6

gpt-image-2.6-flare/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-flare/text-to-image

Entrada

Creaciones

Ver todas las creaciones

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/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-flare/text-to-image es la ruta de generación puramente texto-a-imagen de la serie de imágenes OpenAI gpt-image-2.6, orientada a la velocidad y accesible mediante la interfaz unificada de HiAPI.ai. Convierte un prompt de texto directamente en una imagen final, admite resoluciones de 1K a 4K, múltiples niveles de calidad y planificación de complejidad, relaciones de aspecto habituales, y puede generar PNG, JPEG, WebP, SVG y GIF animados. Es adecuado para desarrolladores que necesitan generar imágenes rápidamente con un bajo coste por imagen, producir en lote o integrar la generación de imágenes en flujos automatizados.

Aspectos clave

Bajo coste por imagen, ideal para generar en lote: se factura por imagen, con un criterio de precio sencillo que facilita estimar y amortizar el coste por imagen en tareas masivas.
Una sola llamada puede producir vectores y animaciones: output_format admite svg y gif, por lo que los recursos vectoriales y las animaciones fotograma a fotograma no requieren otras herramientas.
Calidad y complejidad ajustables por separado: quality controla el nivel de renderizado y complexity controla de forma independiente el nivel de planificación; el texto denso y las maquetas complejas pueden mejorarse según sea necesario.
Amplia cobertura de relaciones de aspecto y resoluciones: ofrece 16 relaciones de aspecto, desde 1:1 hasta 21:9 y 3:1, y permite elegir entre tres resoluciones de salida: 1K, 2K y 4K.

Capacidades

Generación de imágenes directamente a partir de texto: prompt es la única entrada obligatoria, con hasta 32000 caracteres, ideal para convertir directamente descripciones estructuradas largas en imágenes finales sin concatenar parámetros adicionales.

Salida en múltiples formatos, incluidos SVG y GIF: output_format admite png, jpeg, webp, gif y svg; al elegir gif se produce una animación y al elegir svg se obtiene directamente un archivo vectorial, lo que amplía los tipos de recursos entregables.

Parámetros de fotograma GIF controlables: se pueden definir frame_size, frame_count (de 2 a 16 fotogramas) y frame_duration_ms para controlar con precisión el ritmo de la animación y el tamaño del lienzo según las dimensiones en píxeles y el intervalo entre fotogramas.

Fondo transparente y salida comprimida: background puede establecerse en transparent y combinarse con salida png o webp para recursos con fondo transparente; con jpeg y webp se puede usar output_compression para equilibrar tamaño y calidad de imagen.

Calidad, complejidad y resolución por niveles: quality ofrece cinco niveles de renderizado, de low a max; complexity controla de forma independiente la profundidad de planificación; resolution permite elegir 1K, 2K o 4K para equilibrar velocidad y detalle según el caso.

Casos de uso

Generación masiva de imágenes para marketing y redes sociales: introduce el tema de la campaña o la descripción del texto y genera imágenes en lote con relaciones como 16:9 o 1:1, listas para publicarse en redes sociales y materiales publicitarios.
Generación de recursos vectoriales por equipos de diseño: a partir de descripciones de iconos o ilustraciones, obtén archivos SVG para editarlos en herramientas de diseño o usarlos directamente en páginas front-end.
Generación de recursos de animación ligeros por desarrolladores: genera GIF mediante frame_count, frame_duration_ms y frame_size para demostraciones de producto, animaciones de carga o decoración de páginas de campaña.
Imágenes programáticas en flujos automatizados: llama a la interfaz desde sistemas de contenido o scripts de compilación, ensambla prompts y parámetros de resolución y formato según plantillas, y completa las imágenes de artículos o productos en lote.

Limitaciones y recomendaciones de selección

Esta ruta solo procesa texto-a-imagen; cuando se necesiten modificaciones locales sobre una imagen existente o generación a partir de una imagen de referencia, debe utilizarse la ruta image-to-image de la misma serie. La salida GIF tiene un límite máximo en el número total de fotogramas; si el tamaño de fotograma es demasiado grande o hay demasiados fotogramas, el envío se rechazará, y en GIF el lienzo lo determina frame_size, por lo que aspect_ratio solo puede mantenerse en auto. El fondo transparente debe limitarse simultáneamente a png o webp, y al usar output_compression debe especificarse explícitamente output_format. Si se valora más la coherencia de detalles en la edición de múltiples rondas, conviene evaluar primero la variante Sunburst.

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/text-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para gpt-image-2.6-flare/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, con un máximo de 32000 caracteres.

qualitystringOpcionalPredeterminado: "high"

Nivel de calidad de renderizado; valores disponibles: low, medium, high, xhigh, max; si no se especifica, es high.

Opciones:lowmediumhighxhighmax

backgroundstringOpcional

Modo de fondo; valores disponibles: 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 formatos 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 disponibles: auto o low; si no se especifica, es low.

Opciones:autolow

resolutionstringOpcionalPredeterminado: "1K"

Nivel de resolución de salida; valores disponibles: 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. Cuando el tamaño del fotograma es 768x768, el máximo es 12 fotogramas.

aspect_ratiostringOpcionalPredeterminado: "auto"

Relación de aspecto de salida; si no se especifica, es auto. El 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 disponibles: png, jpeg, webp, gif, svg; si no se especifica, es png. gif genera una imagen animada y svg genera un archivo vectorial; 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, redondeado a múltiplos de 10 ms; 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-flare/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-flare/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-flare/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"
    }
  }
}