OpenAI
GPT Image 2.6
gpt-image-2.6-sunburst/text-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
Experimentar gpt-image-2.6-sunburst/text-to-image
Entrada
Saída
imagePreços
gpt-image-2.6-sunburst/text-to-image per image
Posicionamento
gpt-image-2.6-sunburst é a linha de texto para imagem da família de modelos de geração de imagens da OpenAI, voltada a desenvolvedores que precisam produzir imagens em lote por meio da interface unificada do HiAPI.ai. Ele permite gerar imagens diretamente a partir de prompts de texto, com formatos de saída que abrangem bitmaps comuns, além de SVG vetorial e GIF animado, e possibilita controlar as especificações do resultado por parâmetros como qualidade, resolução e proporção. O Sunburst, em iterações múltiplas com qualidade de renderização medium ou superior, mantém melhor a consistência dos detalhes da imagem, sendo adequado a fluxos de trabalho de conteúdo visual que exigem produção contínua e ajustes repetidos.
Destaques principais
- Consistência de detalhes mais estável entre rodadas — em geração ou ajustes múltiplos com qualidade de renderização medium ou high, o Sunburst mantém melhor a consistência dos detalhes da imagem.
- Formatos de saída estendidos a vetorial e animação — a geração texto para imagem pode produzir diretamente arquivos SVG vetoriais e animações GIF, reduzindo a etapa de conversão de formato fora da interface.
- Qualidade de geração e de planejamento ajustáveis separadamente — quality controla a precisão de renderização e complexity controla de forma independente o nível de planejamento, podendo ser elevado isoladamente para textos densos e layouts complexos.
- Proporções que cobrem formatos comerciais comuns — aspect_ratio oferece várias opções, de 1:1 a 21:9, 3:1 e outras, permitindo gerar de uma vez o tamanho correspondente ao canal de veiculação.
Descrição das capacidades
Geração de imagem a partir de texto: basta inserir um prompt de até 32000 caracteres para gerar a imagem, com saída padrão em png, adequada à geração em lote por scripts.
Controle em camadas da qualidade de renderização e do planejamento: quality oferece cinco níveis de precisão de renderização, de low a max, e complexity controla de forma independente o nível de planejamento; para layouts complexos, é possível elevar apenas o planejamento sem aumentar globalmente o nível de renderização.
Definição de resolução e proporção: a resolução pode ser 1K, 2K ou 4K, combinada com várias proporções, gerando diretamente o tamanho final compatível com o layout desejado.
Saída em múltiplos formatos e compressão: opções de png, jpeg, webp, gif e svg; jpeg e webp suportam nível de compressão de 0 a 100, facilitando o equilíbrio entre qualidade de imagem e tamanho do arquivo.
Fundo transparente e animação GIF: ao definir background como transparent, a saída fica restrita a png ou webp; o GIF permite definir número de quadros, tamanho dos quadros e intervalo entre quadros, com a taxa de quadros e o enquadramento determinados diretamente pelos parâmetros.
Cenários de aplicação
- Geração rápida de esboços criativos por equipes de design — gerar várias versões de esboços com prompts curtos, filtrar por nível de qualidade e proporção e depois refinar, para comparação de alternativas na fase de conceito.
- Produção contínua de ativos visuais de marca em série — gerar repetidamente em torno de um mesmo tema, com detalhes mais estáveis em qualidade média ou alta, produzindo materiais diretamente utilizáveis em sites oficiais, páginas de produto e outros itens que exigem unidade de estilo.
- Materiais sociais e de campanha para equipes de marketing — gerar imagens em lote nas proporções 1:1, 9:16, 16:9 e outras, comprimi-las e usá-las em veiculação em redes sociais e landing pages de campanhas.
- Geração de materiais vetoriais e animados por desenvolvedores — escolher saída svg ou gif para obter diretamente gráficos vetoriais ou animações quadro a quadro, para ícones, ilustrações e animações leves.
Limitações e recomendações de escolha
Esta linha suporta apenas geração de imagem a partir de texto; se for necessário fazer modificações locais usando uma imagem existente como entrada, deve-se usar a linha image-to-image. A vantagem de consistência entre rodadas do Sunburst pressupõe qualidade de renderização medium ou high; em níveis de qualidade baixos, não se deve esperar a mesma estabilidade. A saída GIF não suporta o parâmetro de proporção, e o tamanho dos quadros deve ser especificado em pixels, respeitando o limite máximo de quadros; o fundo transparente é compatível apenas com png e webp. Para cenários com exigência rigorosa de velocidade de geração e que não precisam de detalhes estáveis, pode-se avaliar a linha Flare 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
https://api.hiapi.ai/v1/tasks Cabeçalhos
AuthorizationstringObrigatórioChave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API
Content-TypestringOpcionalO 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-KeystringOpcionalChave 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.
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órioValor fixo atual: gpt-image-2.6-sunburst/text-to-image
routestringOpcionalValor fixo atual: default
inputobjectObrigatório
Objeto de parâmetros de negócio para gpt-image-2.6-sunburst/text-to-image e a rota default — veja a tabela de parâmetros abaixo.
promptstringObrigatóriominLength 1maxLength 32000Descreva a imagem a ser gerada, com no máximo 32000 caracteres.
qualitystringOpcionalPadrão: "high"Nível de qualidade de renderização, com opções low, medium, high, xhigh, max; se não informado, o padrão é high.
lowmediumhighxhighmaxbackgroundstringOpcionalModo de fundo, com opções auto, opaque, transparent; transparent exige saída em png ou webp.
autoopaquetransparentcomplexitystringOpcionalNível de planejamento, independente da qualidade de renderização: low é adequado para imagens simples com um único elemento principal, high é adequado para texto denso e layouts complexos; se não informado, o padrão é high.
lowmediumhighframe_sizestringOpcionalpattern ^(auto|[0-9]+x[0-9]+)$Apenas para GIF: largura x altura em pixels de cada quadro, por exemplo 512x512, largura e altura também determinam a proporção do GIF. Ambos os lados devem ser múltiplos de 16; não é aceita a notação de proporção como 1:1; se não informado ou se for passado auto, o padrão é 512x512. Todos os quadros são montados em uma única imagem completa; cada lado da imagem completa não pode exceder 3840, o total de pixels não pode exceder 8.294.400 e a proporção não pode exceder 3:1; se exceder, será rejeitado na fase de envio, sem cobrança. 512x512 suporta de 2 a 16 quadros, 768x768 suporta no máximo 12 quadros.
moderationstringOpcionalNível de moderação de conteúdo, com opções auto ou low; se não informado, o padrão é low.
autolowresolutionstringOpcionalPadrão: "1K"Nível de resolução de saída, com opções 1K, 2K, 4K; se não informado, o padrão é 1K.
1K2K4Kframe_countintegerOpcionalPadrão: 9min 2max 16Apenas para GIF: número de quadros, inteiro de 2 a 16; se não informado, o padrão é 9. Com tamanho de quadro 768x768, no máximo 12 quadros.
aspect_ratiostringOpcionalPadrão: "auto"Proporção de largura e altura da saída; se não informado, o padrão é auto. O GIF não usa este parâmetro: se não informado ou se for passado auto, use frame_size para controlar o tamanho e a proporção de cada quadro.
auto1:13:22:34:33:45:44:5Mostrar tudo (8)
16:99:162:11:221:99:213:11:3output_formatstringOpcionalPadrão: "png"Formato de saída, com opções png, jpeg, webp, gif, svg; se não informado, o padrão é png. gif gera animação, svg gera arquivo vetorial; esses dois formatos só suportam geração de imagem a partir de texto. Ao passar output_compression, é necessário passar também jpeg ou webp; ao passar qualquer um entre frame_size, frame_count e frame_duration_ms, é necessário passar gif.
pngjpegwebpgifsvgframe_duration_msintegerOpcionalPadrão: 200min 20Apenas para GIF: duração de exibição de cada quadro, em milissegundos, mínimo 20, arredondado para múltiplos de 10; se não informado, o padrão é 200.
output_compressionintegerOpcionalmin 0max 100Nível de compressão de 0 a 100, usado apenas para jpeg ou webp; ao passar 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.
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órioObrigató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.
finalstoragestringOpcionalPadrã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.
temppersistentExemplos 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/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-sunburst/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-sunburst/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"
} Obter detalhes da tarefa
https://api.hiapi.ai/v1/tasks/:id Campos da resposta
taskIdstringObrigatórioID da tarefa, sempre com prefixo tk-hiapi-.
modelstringObrigatórioNome 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.
routestringOpcionalPresente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.
statusstringObrigatórioEstado da tarefa.
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órioMomento de criação da tarefa (segundos Unix).
completednumberObrigatórioSegundos 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órioURL do artefato, baixável diretamente.
typestringObrigatórioValores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.
expireAtnumberObrigatórioSegundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.
errorobjectOpcional
Presente apenas com status == fail.
codestringObrigatórioCódigo de erro de negócio.
messagestringObrigatórioDescriçã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"
}
}
} Artigos
Ver todos os artigos →-
Avaliação comparativa
Alternativa ao Replicate: comparação entre hiapi e Replicate para geração de imagem e vídeo (2026)
O que precisa mudar nas chamadas de previsão, nos webhooks e na cobrança ao migrar do Replicate para o hiapi, com uma lista de migração em 10 passos.
-
Avaliação comparativa
OmniHuman 1.5 vs HeyGen Avatar IV:como escolher para locução conduzida por áudio?
Escolha pelos quatro critérios: material de entrada, limite de duração, preço e cenas com várias pessoas.
-
Guia de uso
Receitas de prompt do Qwen Image 2.1 Turbo: 6 prompts em chinês e testes reais de geração de imagens
-
Guia de uso
Preços completos da API GPT Image 2.6: como são cobrados os níveis de qualidade, as resoluções e os formatos de saída
-
Avaliação comparativa
Qwen Image 3.0 vs Nano Banana 2: preço, resolução e como escolher as imagens de referência
Preço unitário de 1K/2K/4K, cobrança de imagens de referência, diferenças de campos da requisição e três grupos de testes reais com o mesmo prompt, para ajudar você a escolher a API de imagem certa na HiAPI.
-
Tutorial
Tutorial de integração da API GPT Image 2.6: seleção entre Flare e Sunburst, prática de saída GIF e SVG
Da seleção do ID do modelo à implementação de parâmetros de texto-para-imagem e imagem-para-imagem, explicando de uma vez os parâmetros de quadros do GIF e a saída SVG
-
Guia de uso
Quanto custa a API do Qwen Image 2.1? Pro a $0.05 por imagem
Os preços por imagem do Pro e do Turbo, o orçamento para diferentes volumes de uso, a comparação com outros modelos de imagem do site e como escolher entre os dois níveis.
-
Tutorial
Casos do Recraft Creative Upscale: upscale de paisagens e aquarela
Veja as mudanças de textura na cabana, no lago e na cidade em aquarela, diferencie o resultado completo da prévia e verifique os detalhes redesenhados.
-
Guia de uso
Receitas de prompts em chinês para o Qwen Image 2.1 Pro: 7 menus, rótulos e pôsteres testados
Modelos relacionados
Ver todos os modelos →Mesmo tipo
-
Wan 2.7 Image Alibaba $0.035 /imagem -
BRIA Product Shot Bria $0.058 /imagem -
FLUX.1 Kontext Max Black Forest Labs $0.071 /imagem -
BRIA Eraser Bria $0.058 /imagem -
Ideogram V4.5 Ideogram $0.011 /imagem -
Qwen Image 3.0 Alibaba $0.036 /imagem -
Krea 2 Medium Turbo Krea $0.021 /imagem -
FLUX.1 Fill Pro Black Forest Labs $0.071 /imagem -
Qwen Image 2.0 Alibaba $0.042 /imagem -
FIBO 1.5 Bria $0.058 /imagem -
Seedream 4.5 ByteDance $0.045 /imagem -
Recraft V4.1 Recraft $0.010 /imagem