Introdução
A edição do Sunburst aceita de 1 a 16 origens e uma instrução de texto sobre o que preservar ou substituir. Uma máscara PNG do mesmo tamanho pode indicar a área a repintar na primeira imagem.
| Campo | Valor |
|---|---|
| Entrada | Imagem |
| Saída | Imagem |
| Publicador | OpenAI |
| Data de lançamento | 2026-11-05 |
| Modelo da API | gpt-image-2.6-sunburst |
| Endpoints públicos | openai/gpt-image-2.6-sunburst/text-to-image; openai/gpt-image-2.6-sunburst/edit |
| Qualidade | low, medium (padrão), high, xhigh, max |
| Resolução | 1k: cerca de 1 MP; 2k: cerca de 3,7 MP; 4k: cerca de 8,3 MP |
| Dimensões em 16:9 | 2k: 2560 x 1440; 4k: 3840 x 2160 |
| Proporções | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| Quantidade de saídas | 1–10 imagens por solicitação |
| Origens para edição | 1–16 imagens de entrada |
| Máscara | PNG opcional nas dimensões da primeira imagem; pixels transparentes indicam onde repintar |
| Fundo | auto, opaque, transparent; a transparência requer PNG ou WebP |
| Formatos de arquivo | PNG (padrão), JPEG, WebP; GIF (somente texto para imagem) |
Recursos e destaques
Giro na varanda
O loop do Sunburst acompanha o giro da paisagem urbana até um sorriso para a câmera na varanda noturna. A sequência de ações bem definida orienta o planejamento preciso do loop no Sunburst.
Brinde no clube de jazz
A animação do Sunburst reúne o brinde, uma piscadela divertida e um sorriso no bar de jazz. A sequência de ações bem definida orienta o planejamento preciso do loop no Sunburst.
Revisão do casaco em Paris
A edição do Sunburst indica primeiro a pessoa a preservar e depois pede um casaco e um cenário chuvoso.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Instrução de revisão obrigatória do Sunburst de até 5.000 caracteres, sem texto padrão; os tokens do prompt são cobrados, então instruções mais longas do Sunburst custam um pouc… pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | Forneça de 1 a 16 URLs de imagens de entrada para o Sunburst, sem origem padrão; identifique-as como Image 1, Image 2 e assim por diante e considere uma pequena taxa por imagem… pelo menos 1 itens · no máximo 16 itens |
mask_url | Não | Máscara PNG opcional do Sunburst, ausente por padrão e com o tamanho da primeira imagem; pixels transparentes indicam a área a repintar, e a máscara não gera cobrança separada. |
markup_url | Não | Sunburst: |
aspect_ratio | Não | Escolha uma das 15 proporções do Sunburst entre 1:3 e 3:1. |
resolution | Não | Escolha o tamanho do Sunburst: 1k (cerca de 1 MP), 2k (cerca de 3,7 MP) ou 4k (cerca de 8,3 MP); nenhum padrão é especificado aqui, e o nível altera o preço. |
quality | Não | Defina o detalhe do Sunburst como low, medium (padrão), high, xhigh ou max; níveis superiores aumentam o detalhe, o tempo de renderização e o preço. |
reasoning_effort | Não | Sunburst: |
num_outputs | Não | Peça de 1 a 10 imagens por solicitação ao Sunburst; nenhuma quantidade padrão é especificada aqui, e cada imagem de saída é cobrada. |
background | Não | As opções de fundo do Sunburst são auto, opaque e transparent, sem padrão especificado aqui; use PNG ou WebP para transparência, sem taxa adicional de fundo. |
output_format | Não | O Sunburst codifica os arquivos em png por padrão, com jpeg e webp como alternativas; a escolha do formato não afeta o preço. |
output_quality | Não | Ao salvar uma edição do Sunburst em JPEG ou WebP, a compressão vai de 0 a 100; no PNG ela não é usada e o preço continua o mesmo. |
Preços
As edições do Sunburst são cobradas pelos tokens que cada solicitação realmente usa: o texto do prompt, os tokens de imagem de todas as imagens fornecidas e os tokens de imagem do resultado. O preço exibido para um nível de qualidade e resolução corresponde a um resultado quadrado do Sunburst sem incluir as imagens de entrada, por isso outras proporções costumam custar menos. O Sunburst contabiliza novamente os tokens do prompt e das entradas para cada saída solicitada. O Sunburst reserva o valor máximo no início do trabalho e devolve a parte não utilizada após a conclusão. Solicitações recusadas pelo Sunburst não são cobradas.
| Resolução | Qualidade: low | Qualidade: medium | Qualidade: high | Qualidade: xhigh | Qualidade: max |
|---|---|---|---|---|---|
| $0.02232 / imagem | $0.03915 / imagem | $0.04743 / imagem | $0.08433 / imagem | $0.18972 / imagem |
| $0.04131 / imagem | $0.07299 / imagem | $0.08847 / imagem | $0.15723 / imagem | $0.35379 / imagem |
| $0.07479 / imagem | $0.13221 / imagem | $0.16011 / imagem | $0.28512 / imagem | $0.64044 / imagem |
Casos de uso
Arte para campanhas de turismo
Monte um pôster à beira-mar com o nome do destino, uma chamada curta e uma paleta de cores definida.
Imagens de cardápios de café
Descreva um layout de lousa com os itens do cardápio entre aspas e um cenário matinal bem definido.
Revisões de retratos
Leve um retrato fornecido para uma rua chuvosa e peça que os traços da origem sejam mantidos.
Guia de prompt e dicas práticas
Defina o briefing visual
Descreva o tema, os materiais e a luz; depois, coloque entre aspas os textos curtos que devem aparecer.
Escolha detalhe e dimensões
Comece com a qualidade medium e selecione 1k, 2k ou 4k conforme o uso da imagem.
Especifique a revisão
Ao editar, coloque a origem primeiro e diga o que deve permanecer antes de descrever a substituição.
Delimite uma área
Forneça uma máscara PNG nas dimensões da primeira imagem quando a mudança se limitar a uma região específica.
Introdução
GPT Image 2.6 Sunburst Edição de imagem altera uma imagem fornecida usando uma instrução escrita. A opção de precisão prioriza a fidelidade e a consistência dos detalhes nas revisões sucessivas, com capacidade para 1–16 imagens de entrada.
Coloque primeiro a imagem a editar e explique a função de cada referência adicional. Uma máscara PNG opcional delimita a região a repintar; nos nossos testes, a troca de roupa e de local preservou a aparência da pessoa.
Recursos e destaques
- Edições anotadas no Sunburst: envie em
markup_urlum PNG transparente do tamanho da primeira imagem, com círculos, esboços ou anotações; o Sunburst não gera uma cobrança separada de entrada e não permitemask_url. - Referências numeradas: chame as origens de Image 1, Image 2 e números seguintes para explicar a contribuição de cada uma.
- Repintura localizada: os pixels transparentes de uma máscara PNG do mesmo tamanho indicam a área a alterar na primeira origem.
- Preservação do formato: omitir
aspect_ratiomantém o formato da primeira imagem em 1k; 2k e 4k exigem uma proporção selecionada. - Controles de detalhe: cinco ajustes de qualidade permitem obter mais detalhe com tempo de renderização e custo adicionais.
- Entrega flexível: salve as revisões em PNG, JPEG ou WebP, com transparência disponível em PNG e WebP.
Casos de uso
- Revisão de roupa: transforme um retrato fornecido numa cena com trench coat cor de camelo para um conceito de campanha.
- Mudança de local: leve uma pessoa de uma imagem existente para uma rua chuvosa de Paris e descreva o que deve permanecer.
- Correção localizada de arte: marque uma região do pôster com uma máscara e peça a substituição de um detalhe do fundo.
Guia de prompts e dicas práticas
- Nomeie a origem: comece com “Image 1 é o retrato a editar” para identificar a base da instrução.
- Descreva a continuidade: acrescente “mantenha a aparência da pessoa” antes de detalhar a nova roupa ou cenário.
- Atribua funções às referências: escreva “use a paleta de cores de Image 2” ao adicionar outra entrada.
- Descreva a substituição na máscara: experimente “substitua a parede marcada por pintura azul-petróleo” com uma máscara PNG correspondente.
- Especifique o novo cenário: use “rua chuvosa de Paris durante a hora azul” para definir local e iluminação em conjunto.
- No Sunburst, ajuste
reasoning_effortà composição: high é o padrão e ajuda com texto denso; mais planejamento leva mais tempo, sem alterar o custo.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "openai/gpt-image-2.6-sunburst/edit",
"input": {
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
