OpenAI

GPT Image 2.6

gpt-image-2.6-sunburst/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-sunburst/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-sunburst/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

Posicionamento

gpt-image-2.6-sunburst/image-to-image é um modelo voltado para edição imagem-para-imagem: recebe uma ou mais imagens de origem e uma descrição de edição, e devolve a imagem modificada. Seu foco é manter a consistência de detalhes em múltiplas rodadas de edição: ao ajustar repetidamente o mesmo personagem, produto ou layout, os detalhes da imagem se mantêm mais estáveis, o que o torna adequado para a produção de ativos visuais que exigem iteração contínua. Desenvolvedores podem chamá-lo pela interface unificada do HiAPI.ai, com cobrança por imagem.

Destaques principais

Consistência de detalhes em múltiplas rodadas de edição — nos níveis de qualidade medium ou high, mantém a consistência de detalhes de personagens, produtos e layouts entre rodadas de edição, sendo ideal para ajustes finos repetidos.
Edição local com anotações — é possível enviar uma camada transparente com marcações circulares ou anotações como dica de modificação; as anotações em si não permanecem na saída.
Composição com múltiplas imagens de origem e saída em formato amplo — permite enviar até 16 imagens de origem de uma só vez e oferece proporções de 3:1 a 1:3 e resoluções de 1K a 4K.

Descrição das capacidades

Edição de imagem a partir de imagens de origem: com 1 a 16 imagens de origem em jpeg, png ou webp, redesenha ou modifica a imagem conforme uma descrição de edição de até 32000 caracteres; o tipo de saída independe das imagens de origem e pode ser convertido diretamente para o formato de entrega desejado.

Duas formas de localização: máscara e anotação: mask_url recebe um PNG RGBA com as mesmas dimensões da primeira imagem de origem, marcando as áreas a editar com pixels transparentes; markup_url usa uma camada transparente como dica de marcação circular. Os dois são mutuamente exclusivos.

Controle em camadas de qualidade e planejamento: quality controla o nível de renderização (low a max) e complexity controla separadamente a profundidade do planejamento; textos densos e layouts complexos permitem aumentar o nível de planejamento sem elevar simultaneamente o custo de renderização.

Formato de saída e tratamento de fundo: permite saída em png, jpeg ou webp; jpeg e webp aceitam nível de compressão de 0 a 100; fundo transparente apenas em png ou webp, ideal para materiais que serão sobrepostos diretamente em páginas ou peças de design.

Resolução e proporção selecionáveis: a resolução de saída pode ser 1K, 2K ou 4K, e a proporção pode acompanhar automaticamente a imagem de origem ou ser escolhida entre 16 predefinições, de 1:1 a 21:9, facilitando a geração já no formato do posicionamento desejado.

Cenários de aplicação

Equipes de design: iteração de séries de personagens e produtos — editar repetidamente imagens existentes com descrições de modificação para produzir ativos visuais de série com detalhes estáveis, usados na padronização de materiais de marca e imagens de produto.
Equipes de marketing: reformulação em lote de materiais de campanha — usar o visual principal existente como imagem de origem e gerar materiais em diferentes proporções e resoluções para diversos posicionamentos, prontos para anúncios e publicação em redes sociais.
Desenvolvedores: modificações locais guiadas por anotações — enviar uma camada com marcações circulares para indicar as áreas a alterar e produzir a imagem com correções locais, integrando-se ao pipeline de produção de conteúdo para reduzir retrabalho manual.
Front-end e construção de páginas: geração de imagens com fundo transparente — usar uma imagem de referência como origem e gerar png ou webp com fundo transparente, usados diretamente em elementos de página e materiais de componentes.

Limitações e recomendações de escolha

As limitações estão principalmente nos níveis de qualidade e nas formas de entrada: a vantagem de consistência de detalhes entre rodadas só se aplica com qualidade medium ou high, não sendo garantida em níveis de qualidade baixos; máscara e anotação não podem ser usadas ao mesmo tempo, e a máscara apenas marca a área de edição, podendo a imagem inteira ainda ser redesenhada; o fundo transparente exige saída em png ou webp, e os parâmetros de compressão só se aplicam a jpeg e webp. Se a tarefa for principalmente geração direta a partir de texto, sem necessidade de restrição por imagem de origem, deve-se usar a linha de geração texto-para-imagem da mesma família.

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

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

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

promptstringObrigatóriominLength 1maxLength 32000

Descreva as modificações a serem feitas na imagem de origem, ou a imagem a ser gerada 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, o padrão é high.

Opções:lowmediumhighxhighmax

mask_urlstringOpcional

URL da imagem de máscara: PNG RGBA com as mesmas dimensões da primeira imagem de origem; pixels totalmente transparentes marcam as áreas a serem modificadas; a imagem inteira ainda pode ser levemente redesenhada. Não pode ser enviado 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 é adequado para textos densos e layouts complexos; quando não informado, o padrão é high.

Opções:lowmediumhigh

image_urlsarrayObrigatóriominItems 1maxItems 16

Array de URLs das imagens de origem, 1–16 imagens http(s) de acesso público, com suporte a jpeg, png, webp.

Array [ string ]

markup_urlstringOpcional

URL da imagem de anotação: camada PNG transparente sobreposta, usando marcações como círculos para indicar os locais a serem modificados; a anotação em si não aparecerá no resultado. Não pode ser enviado junto com mask_url.

moderationstringOpcional

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

Opções:autolow

resolutionstringOpcionalPadrão: "1K"

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

Opções:1K2K4K

aspect_ratiostringOpcionalPadrão: "auto"

Proporção largura-altura da saída; quando não informado, o padrão é 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, o padrão é 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 0–100, usado apenas para jpeg ou webp; ao informar este parâmetro, é necessário definir output_format como jpeg ou webp ao mesmo tempo.

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-sunburst/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-sunburst/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-sunburst/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"
    }
  }
}