Introdução
O text-to-image do Sunburst parte da sua descrição, sem imagem de entrada. A opção de precisão oferece cinco ajustes de qualidade para controlar o detalhe e tamanhos de saída de até cerca de 8,3 megapixels.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| 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 | Descrição de cena obrigatória do Sunburst de até 5.000 caracteres, sem texto padrão; os tokens do prompt são cobrados, então prompts mais longos do Sunburst custam um pouco mais. pelo menos 1 caracteres · no máximo 5000 caracteres |
aspect_ratio | Não | Sunburst usa 1:1 por padrão nas imagens estáticas, com 15 proporções de 1:3 a 3:1; para GIFs, você precisa informar |
resolution | Não | Sunburst: use 1k, 2k ou 4k para imagens estáticas; em GIFs, resolution é o tamanho de um quadro: 512 (cerca de 0,26 MP) aceita até 16 quadros, e 768 (cerca de 0,59 MP), até 12. |
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 | Sunburst aceita auto, opaque e transparent; a transparência exige PNG ou WebP e não pode ser combinada com GIF. |
output_format | Não | Sunburst retorna png por padrão e também aceita jpeg, webp e gif; GIF animado só está disponível em texto para imagem e não aceita fundo transparente. |
frame_count | Não | Sunburst: |
frame_duration_ms | Não | Sunburst: |
output_quality | Não | Escolha a compressão JPEG ou WebP do Sunburst de 0 a 100: valores mais altos preservam mais detalhes num arquivo maior, PNG e GIF ignoram o ajuste, e o preço do Sunburst não muda. |
Preços
O Sunburst cobra os tokens que cada solicitação realmente usa: o texto do prompt e os tokens de imagem do resultado final. O preço exibido para um nível de qualidade e resolução corresponde a uma imagem quadrada do Sunburst, por isso outras proporções costumam custar menos. Pedir mais imagens do Sunburst soma os tokens de cada uma, e os tokens do prompt são contabilizados novamente para cada imagem. 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. Os GIFs do Sunburst seguem o mesmo critério de cobrança: os quadros compartilham folhas, então mais quadros geralmente significam mais tokens de imagem.
| 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.027 / imagem | $0.04752 / imagem | $0.05742 / imagem | $0.10206 / imagem | $0.22941 / imagem |
| $0.04131 / imagem | $0.07299 / imagem | $0.08847 / imagem | $0.15723 / imagem | $0.35379 / imagem |
| $0.04392 / imagem | $0.07776 / imagem | $0.09432 / imagem | $0.1674 / imagem | $0.37638 / 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
Com Sunburst, descreva a cena e a sequência de movimentos com precisão antes de gerar.
Recursos
- Sunburst oferece 1k, 2k e 4k para imagens estáticas, com cinco níveis de qualidade.
- GIFs em loop com Sunburst: descreva o movimento e a repetição, escolha
output_format: gif e informeaspect_ratio. - Sunburst: use 1k, 2k ou 4k para imagens estáticas; em GIFs, resolution é o tamanho de um quadro: 512 (cerca de 0,26 MP) aceita até 16 quadros, e 768 (cerca de 0,59 MP), até 12.
- Sunburst:
frame_countaceita de 2 a 16 quadros, com 9 por padrão; o limite depende do tamanho de quadro selecionado. - Sunburst:
frame_duration_mspermite de 20 a 2000 ms por quadro, com 200 ms por padrão. - No Sunburst, cada GIF é cobrado por folhas de 8 quadros, conforme o nível de qualidade: 9 quadros exigem 2 folhas.
- Sunburst retorna png por padrão e também aceita jpeg, webp e gif; GIF animado só está disponível em texto para imagem e não aceita fundo transparente.
Dicas
- 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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"background": "auto",
"resolution": "1k",
"num_outputs": 1,
"aspect_ratio": "1:1"
}
}'
# 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.
