GPT Image 2.6

O GPT Image 2.6 aceita prompts de texto e imagens de referência opcionais. Envie uma vez para POST /v1/images/generations, guarde o ID de tarefa e consulte GET /v1/tasks/{id} para obter o resultado. Os arquivos prontos são retornados como URLs.

IDs de modelo e preços

Use GET /v1/models para descobrir os modelos disponíveis para sua chave. Os IDs de Sunburst configurados são gpt-image-2.6-sunburst-official e gpt-image-2.6-sunburst. Os IDs de Flare, quando listados, usam o mesmo contrato de parâmetros. O ID de modelo sem sufixo usa seu grupo Default; grupos adicionais usam o ID model:group mostrado pela consulta de modelos.

Veja os preços atuais e o Playground. Modelos cobrados por token são liquidados pelo uso real; modelos cobrados por imagem usam o preço de imagem configurado. As respostas SVG informam separadamente em svg_usage os tokens do modelo que escreve o código, cobrados pelo preço próprio desse modelo no SeedRouter.

Gerar uma imagem

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

A resposta contém um id. Consulte esse ID em vez de enviar a geração novamente:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Na conclusão, output.data contém objetos com uma url. Baixe a URL para preservar o formato original do arquivo e, nos GIFs, todos os quadros da animação. Uma tarefa que falha contém um error e não é cobrada. Veja os estados de tarefa e a consulta de status.

Parâmetros

Há 18 campos de nível superior. Apenas model e prompt são obrigatórios. Campos opcionais aceitam null, que equivale à omissão. Campos desconhecidos são descartados. Valores inválidos de parâmetros aceitos falham na validação antes da geração de imagens.

As URLs de referência devem usar HTTP ou HTTPS e não podem conter credenciais. IDs de arquivo, base64 em linha e envios multipart não são aceitos; envie os arquivos primeiro e forneça suas URLs públicas. As requisições usam consulta de tarefas assíncronas em vez de stream ou partial_images. input_fidelity, response_format e prompt_rewriter não são expostos por este contrato.

Tamanho da imagem

Para a geração de PNG, JPEG e imagens de referência para SVG, cada dimensão deve ser divisível por 16 e não pode ultrapassar 3840 pixels. O total de pixels deve ficar entre 655.360 e 8.294.400 e a proporção entre 1:3 e 3:1. Exemplos: 1024x1024, 1536x1024, 2160x3840, 2880x2880.

As dimensões de GIF devem ser múltiplos positivos de 16, ou você pode usar auto. GIF tem um limite total de pixels separado, compartilhado entre a quantidade de quadros, suas dimensões e n; a OpenAI não publicou o limite numérico. Um GIF de 512x512 não usa a regra de mínimo de pixels de imagens estáticas.

GIF animado

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

GIF pode ser gerado a partir de um prompt ou solicitado a partir de imagens de referência. Não combine com máscara ou compressão. A disponibilidade da prévia pode depender do acesso do modelo selecionado.

Divergência na documentação, verificada em 5 de novembro de 2026: o guia de geração de imagens da OpenAI informa 2–64 quadros e 20–2000 ms e diz que o endpoint de edição não retorna GIFs. A referência da Images API informa 2–16 quadros, sem duração máxima, e lista saída GIF nas edições. Requisições ao serviço de origem em 5 de novembro de 2026 corresponderam à referência: 17 quadros foram recusados e um quadro de 3.000 ms foi aceito. Esta API segue a referência.

SVG

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

SVG é exclusivo da geração e exige n: 1. Não envie imagens, máscara, marcações ou compressão. O arquivo é XML UTF-8 estático contendo formas vetoriais; scripts, recursos externos e imagens rasterizadas incorporadas não são aceitos.

Quando a seleção do modelo que escreve o código estiver disponível, acrescente svg: {"model":"YOUR_AUTHOR_MODEL_ID"}. Um objeto svg fornecido explicitamente exige um model não vazio. Você também pode definir svg.reasoning.effort como none, minimal, low, medium, high, xhigh ou max; o modelo selecionado determina os valores aceitos. Omita reasoning para usar o padrão dele. A OpenAI não publica uma lista de modelos permitidos para escrever o código nem um padrão universal. Se a seleção não estiver disponível, omita todo o objeto svg.

O resultado concluído pode incluir svg_usage com model, input_tokens, output_tokens, reasoning_tokens e total_tokens. Isso é separado do usage de imagem, não uma contagem adicional de tokens de imagem.

Imagens de referência, máscara e marcações

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

As imagens de referência aceitam PNG, JPEG e WebP, com até 50 MB cada. A máscara e as marcações devem ser PNG e ter as mesmas dimensões da primeira imagem de referência após a orientação. As marcações devem conter pixels transparentes; tanto as marcações quanto a primeira imagem de referência podem ter até 16.777.216 pixels, e as marcações podem ocupar até 50 MB. Máscara e marcações são mutuamente exclusivas.

Campos de resposta

A saída de imagem concluída contém created, data: [{url}] e, quando informados, size, quality, background, output_format, usage, svg_usage e safety_identifier. usage pode detalhar tokens de entrada e saída de texto e imagem e entrada em cache. A saída pública não inclui bytes de imagem em base64 nem campos de custo.

Esquema OpenAPI · Referência de geração da OpenAI · Referência de edição da OpenAI · Guia de imagens da OpenAI