OpenAI

GPT Image 2.6

gpt-image-2.6-flare/image-to-image

Modelos de geração e edição de imagens da OpenAI em duas categorias: o Flare foca em velocidade, o Sunburst busca precisão, com saída direta de GIFs animados e vetores SVG, além de suportar edição local de imagens

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

Experimentar gpt-image-2.6-flare/image-to-image

Entrada

Saída

image

Preencha os parâmetros e gere — os resultados aparecerão aqui.

Preços

GPT Image 2.6: lançamento com 20% de desconto por tempo limitado 20% OFF · Termina a 2026-11-13 Ver oferta

gpt-image-2.6-flare/image-to-image per image

Especificações	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

Visão geral

O modelo de imagem para imagem gpt-image-2.6-flare é voltado a desenvolvedores que precisam modificar, expandir e recriar materiais existentes. Ele recebe uma imagem de origem como entrada e usa o prompt como instrução para concluir a edição, podendo receber até 16 imagens de referência em uma única chamada, além de oferecer suporte a repintura local com máscara, prompts com anotações e saída em resoluções de 1K a 4K. É adequado para incorporar recursos de edição de imagens em fluxos automatizados de produção de conteúdo, materiais de e-commerce e geração de imagens de marketing.

Destaques principais

Aceita até 16 imagens de origem por chamada — várias imagens de referência podem servir simultaneamente de base para a edição, reduzindo chamadas em lotes e a junção de resultados.
Duas formas de controle local: máscara e anotação — a máscara define a área a ser repintada; a imagem anotada serve para demarcar o prompt e não é mantida na saída. As duas não podem ser usadas ao mesmo tempo.
Qualidade e complexidade ajustadas separadamente — a qualidade de renderização e a complexidade de planejamento têm níveis próprios, permitindo escolhas distintas conforme a dificuldade da tarefa, sem elevar ou reduzir tudo em conjunto.
Resolução e formato de imagem definidos conforme o destino da saída — suporta 1K, 2K, 4K e várias proporções de quadro, podendo também seguir a imagem de origem ou ser decidido automaticamente pelo modelo.

Descrição das capacidades

Edição por instrução baseada na imagem de origem: descreva a intenção de modificação com um prompt e conclua a edição com 1 a 16 imagens de origem em jpeg, png ou webp; é indicado para transformações direcionadas sobre a imagem original, não para geração do zero.

Repintura local com máscara: forneça uma máscara PNG RGBA com o mesmo tamanho da primeira imagem de origem; os pixels transparentes marcam a área de edição. Áreas fora da máscara também podem sofrer pequenas alterações.

Posicionamento de modificações com prompts anotados: use um PNG transparente com anotações, como demarcações, como pista auxiliar para orientar o modelo a focar na área desejada; a anotação em si não aparece na saída.

Controle de formato de saída e fundo: é possível escolher saída em png, jpeg ou webp; jpeg e webp suportam níveis de compressão de 0 a 100; quando é necessário fundo transparente, o formato de saída fica limitado a png ou webp.

Níveis de qualidade, complexidade e moderação de conteúdo: a qualidade de renderização tem cinco níveis e a complexidade de planejamento tem três, permitindo atender tanto a retoques finos quanto a tarefas com texto denso e layouts complexos; a moderação de conteúdo pode ser automática ou em nível baixo.

Cenários de aplicação

Iterações múltiplas de equipes de design sobre materiais existentes — insira peças visuais já existentes e instruções de modificação, ajuste composição e detalhes a cada rodada e produza ativos de imagem prontos para revisão.
Recriação de materiais por equipes de e-commerce e marca — use imagens de produto ou visuais principais como origem, substitua fundos, expanda cenários ou corrija partes locais para obter imagens de produtos e campanhas prontas para publicação.
Fluxos de composição e retoque local — use máscara ou anotação para localizar a área a alterar, ajuste apenas a parte indicada e gere gráficos para composição em pôsteres, páginas de detalhes e outros layouts.
Necessidades de entrega em alta resolução — defina diretamente resolução 2K ou 4K e a proporção de quadro desejada, reduzindo etapas posteriores de ampliação e corte.

Limitações e recomendações de escolha

Este é um modelo de edição de imagem para imagem e não possui capacidade de geração de imagem a partir de texto; para gerar imagens do zero, é preciso usar a linha text-to-image da mesma série. O controle local depende de máscara ou anotação, e áreas fora da máscara também podem sofrer pequenas alterações. A saída com fundo transparente está sujeita a restrições de formato, exigindo png ou webp; os níveis de compressão só se aplicam a jpeg e webp. Quando for necessário manter a consistência de detalhes ao longo de várias rodadas de edição, pode-se optar pela linha Sunburst da mesma série.

Perguntas frequentes

Ver todas as perguntas →

Como funciona a cobrança? Há cobrança se a solicitação for rejeitada?

Cobrança por imagem, com o preço unitário definido pelo nível de qualidade e pela resolução, conforme a tabela de preços desta página; Flare e Sunburst têm o mesmo preço. Na geração imagem-para-imagem, cada imagem de referência acrescenta $0.012. Os GIFs são cobrados separadamente por nível de qualidade, independentemente da resolução. Solicitações como parâmetros inválidos ou tamanho de GIF acima do limite são rejeitadas já na fase de envio, e o valor pré-cobrado é reembolsado integralmente, sem cobrança.
É possível modificar apenas uma parte da imagem?

Sim, usando a rota de imagem para imagem, com uma das duas opções. A primeira é mask_url: envie um PNG RGBA com as mesmas dimensões da primeira imagem de origem; os pixels totalmente transparentes são a área a ser modificada. A segunda é markup_url: envie uma imagem PNG transparente com anotações, usando marcações como círculos para indicar as posições a alterar; as anotações em si não aparecem no resultado. As duas opções não podem ser enviadas ao mesmo tempo. Mesmo usando a máscara, o modelo ainda pode fazer uma leve repintura na imagem inteira.
Qual é a diferença entre Flare e Sunburst e qual devo escolher?

Ambos têm parâmetros, uso e preço exatamente iguais; a diferença está no foco. Segundo a descrição da OpenAI, o Flare gera imagens mais rápido, sendo adequado para iteração rápida e geração em lote, e é a opção padrão recomendada; o Sunburst dá mais ênfase aos detalhes e, ao fazer várias rodadas de edição nos níveis de qualidade medium ou superior, mantém com mais consistência os detalhes de personagens, produtos ou layouts. Em geral, use o Flare primeiro; quando a mesma imagem precisar ser modificada repetidamente e for necessário manter a estabilidade dos detalhes, troque para o Sunburst e defina quality como medium ou superior.
É possível gerar diretamente GIFs animados ou imagens vetoriais SVG?

Sim, na rota de geração de imagem a partir de texto basta definir output_format como gif ou svg; a rota de imagem para imagem suporta apenas png, jpeg e webp. O GIF é controlado por três parâmetros: frame_size define o tamanho em pixels de cada quadro (padrão 512x512; largura e altura também determinam a proporção do GIF), frame_count define o número de quadros (2–16, padrão 9) e frame_duration_ms define a duração de cada quadro (padrão 200 milissegundos). Ao gerar um GIF, não envie aspect_ratio ou envie auto.

Criar uma tarefa de geração

POST https://api.hiapi.ai/v1/tasks

Cabeçalhos

AuthorizationstringObrigatório

Chave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API

Content-TypestringOpcional

O corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.

Idempotency-KeystringOpcional

Chave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.

Chave de idempotência

Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.

Corpo

modelstringObrigatório

Valor fixo atual: gpt-image-2.6-flare/image-to-image

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para gpt-image-2.6-flare/image-to-image e a rota default — veja a tabela de parâmetros abaixo.

promptstringObrigatóriominLength 1maxLength 32000

Descreva as modificações a fazer na imagem de origem, ou a imagem a gerar com base na imagem de origem, com no máximo 32000 caracteres.

qualitystringOpcionalPadrão: "high"

Nível de qualidade de renderização, opções: low, medium, high, xhigh, max; quando não informado, é high.

Opções:lowmediumhighxhighmax

mask_urlstringOpcional

URL da imagem de máscara: um PNG RGBA com as mesmas dimensões da primeira imagem de origem, em que os pixels totalmente transparentes marcam as áreas a modificar; a imagem inteira ainda pode sofrer pequenas repinturas. Não pode ser informado junto com markup_url.

backgroundstringOpcional

Modo de fundo, opções: auto, opaque, transparent; transparent requer saída em png ou webp.

Opções:autoopaquetransparent

complexitystringOpcional

Nível de planejamento, independente da qualidade de renderização: low é adequado para modificações locais e pontuais, high para texto denso e layouts complexos; quando não informado, é high.

Opções:lowmediumhigh

image_urlsarrayObrigatóriominItems 1maxItems 16

Array de URLs das imagens de origem, de 1 a 16 imagens http(s) acessíveis publicamente, com suporte a jpeg, png e webp.

Array [ string ]

markup_urlstringOpcional

URL da imagem de anotação: uma camada PNG transparente que indica, com marcações como círculos, os locais a modificar; a anotação em si não aparece no resultado. Não pode ser informada junto com mask_url.

moderationstringOpcional

Nível de moderação de conteúdo, opções: auto ou low; quando não informado, é low.

Opções:autolow

resolutionstringOpcionalPadrão: "1K"

Nível de resolução de saída, opções: 1K, 2K, 4K; quando não informado, é 1K.

Opções:1K2K4K

aspect_ratiostringOpcionalPadrão: "auto"

Proporção de aspecto da saída; quando não informada, é auto, ou seja, segue a proporção da imagem de origem.

Opções:auto1:13:22:34:33:45:44:5

Mostrar tudo (8)

16:99:162:11:221:99:213:11:3

output_formatstringOpcionalPadrão: "png"

Formato de saída, opções: png, jpeg, webp; quando não informado, é png. Ao informar output_compression, é necessário informar também jpeg ou webp.

Opções:pngjpegwebp

output_compressionintegerOpcionalmin 0max 100

Nível de compressão de 0 a 100, usado apenas para jpeg ou webp; ao informar este parâmetro, é necessário definir output_format como jpeg ou webp.

callbackobjectOpcional

Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.

Callbacks (Webhook)

Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.

urlstringObrigatório

Obrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.

whenstringOpcionalPadrão: "final"

Atualmente só há suporte a final — notifica tanto em success quanto em fail.

Opções:final

storagestringOpcionalPadrão: "temp"

Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.

Opções:temppersistent

Exemplos de requisição

# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
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/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-flare/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-flare/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"
}

Obter detalhes da tarefa

GET https://api.hiapi.ai/v1/tasks/:id

Campos da resposta

taskIdstringObrigatório

ID da tarefa, sempre com prefixo tk-hiapi-.

modelstringObrigatório

Nome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.

routestringOpcional

Presente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.

statusstringObrigatório

Estado da tarefa.

Valores de status

queued Na fila, ainda não iniciada. handling Em processamento. archiving Processamento concluído, preparando artefatos. success Terminal: concluído, artefatos disponíveis (retorna output). fail Terminal: falha (retorna error). Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.

creatednumberObrigatório

Momento de criação da tarefa (segundos Unix).

completednumberObrigatório

Segundos Unix do estado terminal; 0 enquanto não terminal.

outputarrayOpcional

Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).

Array [ object ]

Itens do array

urlstringObrigatório

URL do artefato, baixável diretamente.

typestringObrigatório

Valores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.

expireAtnumberObrigatório

Segundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.

errorobjectOpcional

Presente apenas com status == fail.

codestringObrigatório

Código de erro de negócio.

messagestringObrigatório

Descrição do erro.

Exemplos de resposta

Sucesso

{
  "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
      }
    ]
  }
}

Em processamento (não final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Falhou

{
  "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"
    }
  }
}