# ChatGPT Images 2.6 API Referência completa da API para os modelos ChatGPT Images 2.6 Flare e Sunburst. ## Variantes dos modelos Esta API oferece suporte a quatro variantes de modelos: | Modelo | ID | Descrição | |-------|-----|-------------| | **ChatGPT Images 2.6 Flare** | `gpt-image-2.6-flare` | Geração de imagens a partir de texto com controles de resolução e qualidade | | **ChatGPT Images 2.6 Flare Edit** | `gpt-image-2.6-flare-edit` | Edição de imagens e composição com várias imagens | | **ChatGPT Images 2.6 Sunburst** | `gpt-image-2.6-sunburst` | Geração de imagens a partir de texto com controles de resolução e qualidade | | **ChatGPT Images 2.6 Sunburst Edit** | `gpt-image-2.6-sunburst-edit` | Edição de imagens e composição com várias imagens | ## Comparação rápida Flare e Sunburst compartilham as seguintes opções de solicitação. | Recurso | Flare / Sunburst | Flare Edit / Sunburst Edit | |---------|-----------------|---------------------------| | Entrada | Prompt de texto | Imagem(ns) + prompt de texto | | Opções de resolução | `1k`, `2k`, `4k` | `1k`, `2k`, `4k` | | Opções de qualidade | `low`, `medium`, `high`, `xhigh`, `max` | `low`, `medium`, `high`, `xhigh`, `max` | | Qualidade padrão | `medium` | `medium` | | Proporções | 10 opções | 10 opções | | Imagens de entrada | Não | Obrigatórias (1–16 imagens) | | Formatos de saída | `png`, `jpeg`, `webp`, `gif`, `svg` | `png`, `jpeg`, `webp` | | Formato de saída padrão | `png` | `png` | ### Proporções compatíveis `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 para imagem) ### Ponto de extremidade ``` POST /api/v1/image/task ``` ### Autenticação ``` Authorization: Bearer YOUR_API_KEY ``` ### Parâmetros da solicitação #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model_name` | string | Deve ser `"gpt-image-2.6-flare"` | | `prompt` | string | Prompt para geração de imagem | | `width` | integer | Valor da largura na proporção, como `16` para `16:9`; não é uma dimensão em pixels | | `height` | integer | Valor da altura na proporção, como `9` para `16:9`; não é uma dimensão em pixels | | `resolution` | string | `"1k"`, `"2k"` ou `"4k"` | A proporção width:height deve corresponder a uma das proporções compatíveis listadas acima. #### Opcionais | Parâmetro | Tipo | Padrão | Descrição | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"` | | `output_format` | string | `"png"` | Formato de saída: `"png"`, `"jpeg"`, `"webp"`, `"gif"` ou `"svg"`. Use `"gif"` para animações GIF ou `"svg"` para saída vetorial SVG | | `frame_count` | integer | `9` | Número de quadros do GIF, de `2` a `16`. Aplica-se apenas quando `output_format` é `"gif"` | | `frame_duration_ms` | integer | `200` | Duração de cada quadro do GIF em milissegundos, de `20` a `2000`. Aplica-se apenas quando `output_format` é `"gif"` | ### Exemplo de solicitação ```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 (Edição de imagens) ### Ponto de extremidade ``` POST /api/v1/image/task ``` ### Parâmetros da solicitação #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model_name` | string | Deve ser `"gpt-image-2.6-flare-edit"` | | `prompt` | string | Descrição das alterações desejadas | | `image_url_list` | string[] | URLs das imagens de entrada; no mínimo 1 e no máximo 16 imagens, cada uma com menos de 50 MB | | `width` | integer | Valor da largura na proporção, como `16` para `16:9`; não é uma dimensão em pixels | | `height` | integer | Valor da altura na proporção, como `9` para `16:9`; não é uma dimensão em pixels | | `resolution` | string | `"1k"`, `"2k"` ou `"4k"` | A proporção width:height deve corresponder a uma das proporções compatíveis listadas acima. #### Opcionais | Parâmetro | Tipo | Padrão | Descrição | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"` | | `output_format` | string | `"png"` | Formato de saída: `"png"`, `"jpeg"` ou `"webp"` | ### Exemplo de solicitação ```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 para imagem) ### Ponto de extremidade ``` POST /api/v1/image/task ``` ### Parâmetros da solicitação #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model_name` | string | Deve ser `"gpt-image-2.6-sunburst"` | | `prompt` | string | Prompt para geração de imagem | | `width` | integer | Valor da largura na proporção, como `16` para `16:9`; não é uma dimensão em pixels | | `height` | integer | Valor da altura na proporção, como `9` para `16:9`; não é uma dimensão em pixels | | `resolution` | string | `"1k"`, `"2k"` ou `"4k"` | A proporção width:height deve corresponder a uma das proporções compatíveis listadas acima. #### Opcionais | Parâmetro | Tipo | Padrão | Descrição | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"` | | `output_format` | string | `"png"` | Formato de saída: `"png"`, `"jpeg"`, `"webp"`, `"gif"` ou `"svg"`. Use `"gif"` para animações GIF ou `"svg"` para saída vetorial SVG | | `frame_count` | integer | `9` | Número de quadros do GIF, de `2` a `16`. Aplica-se apenas quando `output_format` é `"gif"` | | `frame_duration_ms` | integer | `200` | Duração de cada quadro do GIF em milissegundos, de `20` a `2000`. Aplica-se apenas quando `output_format` é `"gif"` | ### Exemplo de solicitação ```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 (Edição de imagens) ### Ponto de extremidade ``` POST /api/v1/image/task ``` ### Parâmetros da solicitação #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model_name` | string | Deve ser `"gpt-image-2.6-sunburst-edit"` | | `prompt` | string | Descrição das alterações desejadas | | `image_url_list` | string[] | URLs das imagens de entrada; no mínimo 1 e no máximo 16 imagens, cada uma com menos de 50 MB | | `width` | integer | Valor da largura na proporção, como `16` para `16:9`; não é uma dimensão em pixels | | `height` | integer | Valor da altura na proporção, como `9` para `16:9`; não é uma dimensão em pixels | | `resolution` | string | `"1k"`, `"2k"` ou `"4k"` | A proporção width:height deve corresponder a uma das proporções compatíveis listadas acima. #### Opcionais | Parâmetro | Tipo | Padrão | Descrição | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"` | | `output_format` | string | `"png"` | Formato de saída: `"png"`, `"jpeg"` ou `"webp"` | ### Exemplo de solicitação ```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 da resposta ### Resposta inicial Todas as quatro variantes do ChatGPT Images 2.6 retornam um `task_id` para consultas periódicas: ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "submitted", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}" }, "message": "success" } ``` ### Resposta às consultas periódicas Consulte periodicamente `GET /api/v1/image/{task_id}` para verificar o status: ```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 status - `submitted`: Tarefa aceita - `processing`: Geração ou edição de imagem em andamento - `succeed`: Tarefa concluída com sucesso - `failed`: Falha na tarefa ## Tempo de processamento O tempo de processamento varia conforme o modelo, as configurações de saída, a complexidade do prompt e o número de imagens de referência. Faça consultas periódicas até que o status da tarefa seja `succeed` ou `failed`; uma tarefa enviada ou em processamento pode ainda não conter imagens resultantes. ## Boas práticas 1. **Descreva a composição com clareza**: O ChatGPT Images 2.6 oferece os melhores resultados quando os prompts descrevem claramente o assunto, o enquadramento, a iluminação e o estilo desejado. 2. **Adapte a proporção ao destino de publicação**: Defina a proporção antecipadamente para publicações em redes sociais, banners, páginas de produtos ou layouts editoriais. 3. **Use imagens de origem nítidas para edições**: Imagens nítidas e bem iluminadas melhoram a preservação da identidade e a qualidade das edições locais. 4. **Limite as solicitações com várias imagens a referências relevantes**: Nas solicitações de edição, forneça apenas as imagens necessárias para evitar orientações visuais conflitantes.