# ChatGPT Images 2.6 API Referencia completa de la API para los modelos ChatGPT Images 2.6 Flare y Sunburst. ## Variantes de modelos Esta API admite cuatro variantes de modelos: | Modelo | ID | Descripción | |-------|-----|-------------| | **ChatGPT Images 2.6 Flare** | `gpt-image-2.6-flare` | Generación de imágenes a partir de texto con controles de resolución y calidad | | **ChatGPT Images 2.6 Flare Edit** | `gpt-image-2.6-flare-edit` | Edición de imágenes y composición con varias imágenes | | **ChatGPT Images 2.6 Sunburst** | `gpt-image-2.6-sunburst` | Generación de imágenes a partir de texto con controles de resolución y calidad | | **ChatGPT Images 2.6 Sunburst Edit** | `gpt-image-2.6-sunburst-edit` | Edición de imágenes y composición con varias imágenes | ## Comparación rápida Flare y Sunburst comparten las siguientes opciones de solicitud. | Característica | Flare / Sunburst | Flare Edit / Sunburst Edit | |---------|-----------------|---------------------------| | Entrada | Prompt de texto | Imagen(es) + prompt de texto | | Opciones de resolución | `1k`, `2k`, `4k` | `1k`, `2k`, `4k` | | Opciones de calidad | `low`, `medium`, `high`, `xhigh`, `max` | `low`, `medium`, `high`, `xhigh`, `max` | | Calidad predeterminada | `medium` | `medium` | | Relaciones de aspecto | 10 opciones | 10 opciones | | Imágenes de entrada | No | Obligatorias (1–16 imágenes) | | Formatos de salida | `png`, `jpeg`, `webp`, `gif`, `svg` | `png`, `jpeg`, `webp` | | Formato de salida predeterminado | `png` | `png` | ### Relaciones de aspecto admitidas `16:9`, `9:16`, `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `5:4`, `4:5`, `21:9` ## ChatGPT Images 2.6 Flare (Texto a imagen) ### Punto de conexión ``` POST /api/v1/image/task ``` ### Autenticación ``` Authorization: Bearer YOUR_API_KEY ``` ### Parámetros de la solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model_name` | string | Debe ser `"gpt-image-2.6-flare"` | | `prompt` | string | Prompt para generar la imagen | | `width` | integer | Valor de ancho de la proporción, como `16` para `16:9`; no es una dimensión en píxeles | | `height` | integer | Valor de alto de la proporción, como `9` para `16:9`; no es una dimensión en píxeles | | `resolution` | string | `"1k"`, `"2k"` o `"4k"` | La proporción width:height debe coincidir con una de las relaciones de aspecto admitidas indicadas arriba. #### Opcionales | Parámetro | Tipo | Valor predeterminado | Descripción | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` o `"max"` | | `output_format` | string | `"png"` | Formato de salida: `"png"`, `"jpeg"`, `"webp"`, `"gif"` o `"svg"`. Usa `"gif"` para animaciones GIF o `"svg"` para la salida vectorial SVG | | `frame_count` | integer | `9` | Número de fotogramas GIF, de `2` a `16`. Solo se aplica cuando `output_format` es `"gif"` | | `frame_duration_ms` | integer | `200` | Duración de cada fotograma GIF en milisegundos, de `20` a `2000`. Solo se aplica cuando `output_format` es `"gif"` | ### Ejemplo de solicitud ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-flare', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Flare Edit (Edición de imágenes) ### Punto de conexión ``` POST /api/v1/image/task ``` ### Parámetros de la solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model_name` | string | Debe ser `"gpt-image-2.6-flare-edit"` | | `prompt` | string | Descripción de las modificaciones deseadas | | `image_url_list` | string[] | URL de las imágenes de entrada; entre 1 y 16 imágenes, cada una de menos de 50 MB | | `width` | integer | Valor de ancho de la proporción, como `16` para `16:9`; no es una dimensión en píxeles | | `height` | integer | Valor de alto de la proporción, como `9` para `16:9`; no es una dimensión en píxeles | | `resolution` | string | `"1k"`, `"2k"` o `"4k"` | La proporción width:height debe coincidir con una de las relaciones de aspecto admitidas indicadas arriba. #### Opcionales | Parámetro | Tipo | Valor predeterminado | Descripción | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` o `"max"` | | `output_format` | string | `"png"` | Formato de salida: `"png"`, `"jpeg"` o `"webp"` | ### Ejemplo de solicitud ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-flare-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst (Texto a imagen) ### Punto de conexión ``` POST /api/v1/image/task ``` ### Parámetros de la solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model_name` | string | Debe ser `"gpt-image-2.6-sunburst"` | | `prompt` | string | Prompt para generar la imagen | | `width` | integer | Valor de ancho de la proporción, como `16` para `16:9`; no es una dimensión en píxeles | | `height` | integer | Valor de alto de la proporción, como `9` para `16:9`; no es una dimensión en píxeles | | `resolution` | string | `"1k"`, `"2k"` o `"4k"` | La proporción width:height debe coincidir con una de las relaciones de aspecto admitidas indicadas arriba. #### Opcionales | Parámetro | Tipo | Valor predeterminado | Descripción | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` o `"max"` | | `output_format` | string | `"png"` | Formato de salida: `"png"`, `"jpeg"`, `"webp"`, `"gif"` o `"svg"`. Usa `"gif"` para animaciones GIF o `"svg"` para la salida vectorial SVG | | `frame_count` | integer | `9` | Número de fotogramas GIF, de `2` a `16`. Solo se aplica cuando `output_format` es `"gif"` | | `frame_duration_ms` | integer | `200` | Duración de cada fotograma GIF en milisegundos, de `20` a `2000`. Solo se aplica cuando `output_format` es `"gif"` | ### Ejemplo de solicitud ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-sunburst', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst Edit (Edición de imágenes) ### Punto de conexión ``` POST /api/v1/image/task ``` ### Parámetros de la solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model_name` | string | Debe ser `"gpt-image-2.6-sunburst-edit"` | | `prompt` | string | Descripción de las modificaciones deseadas | | `image_url_list` | string[] | URL de las imágenes de entrada; entre 1 y 16 imágenes, cada una de menos de 50 MB | | `width` | integer | Valor de ancho de la proporción, como `16` para `16:9`; no es una dimensión en píxeles | | `height` | integer | Valor de alto de la proporción, como `9` para `16:9`; no es una dimensión en píxeles | | `resolution` | string | `"1k"`, `"2k"` o `"4k"` | La proporción width:height debe coincidir con una de las relaciones de aspecto admitidas indicadas arriba. #### Opcionales | Parámetro | Tipo | Valor predeterminado | Descripción | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` o `"max"` | | `output_format` | string | `"png"` | Formato de salida: `"png"`, `"jpeg"` o `"webp"` | ### Ejemplo de solicitud ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-sunburst-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Formato de respuesta ### Respuesta inicial Las cuatro variantes de ChatGPT Images 2.6 devuelven un `task_id` para consultar periódicamente el estado: ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "submitted", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}" }, "message": "success" } ``` ### Respuesta a consultas periódicas Consulta periódicamente `GET /api/v1/image/{task_id}` para comprobar el estado: ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "succeed", "task_status_msg": null, "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_result": { "credit": 0.0997, "images": [ { "url": "https://example.com/generated-image.jpeg" } ] } }, "message": "success" } ``` ### Valores de estado - `submitted`: Tarea aceptada - `processing`: Generación o edición de imagen en curso - `succeed`: Tarea completada correctamente - `failed`: La tarea falló ## Tiempo de procesamiento El tiempo de procesamiento varía según el modelo, la configuración de salida, la complejidad del prompt y el número de imágenes de referencia. Consulta periódicamente hasta que el estado de la tarea sea `succeed` o `failed`; una tarea enviada o en procesamiento puede que aún no contenga imágenes resultantes. ## Buenas prácticas 1. **Describe la composición con precisión**: ChatGPT Images 2.6 ofrece mejores resultados cuando los prompts describen con claridad el sujeto, el encuadre, la iluminación y el estilo deseado. 2. **Adapta la relación de aspecto al destino de publicación**: Define la proporción desde el principio para publicaciones en redes sociales, banners, páginas de productos o diseños editoriales. 3. **Usa imágenes de origen nítidas para las ediciones**: Las imágenes nítidas y bien iluminadas mejoran la conservación de la identidad y la calidad de las ediciones locales. 4. **Limita las solicitudes con varias imágenes a referencias relevantes**: En las solicitudes de edición, proporciona solo las imágenes necesarias para evitar indicaciones visuales contradictorias.