OpenAI

GPT Image 2.6

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

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-flare/text-to-image

Entrada

Criações

Ver todas as criações

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-flare/text-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
svg · 1K	~~$0.053~~ $0.0424	~~$0.071~~ $0.0568	~~$0.079~~ $0.0632	~~$0.117~~ $0.0936	~~$0.225~~ $0.180
svg · 2K	~~$0.072~~ $0.0576	~~$0.105~~ $0.084	~~$0.120~~ $0.096	~~$0.190~~ $0.152	~~$0.390~~ $0.312
svg · 4K	~~$0.105~~ $0.084	~~$0.163~~ $0.1304	~~$0.190~~ $0.152	~~$0.313~~ $0.2504	~~$0.666~~ $0.5328
gif · 1K · 2K · 4K	~~$0.070~~ $0.056	~~$0.124~~ $0.0992	~~$0.150~~ $0.120	~~$0.266~~ $0.2128	~~$0.598~~ $0.4784

Visão geral do posicionamento

gpt-image-2.6-flare/text-to-image é a rota de geração puramente textual, com foco em velocidade, da série de imagens OpenAI gpt-image-2.6, chamada por meio da interface unificada do HiAPI.ai. Ele converte um prompt de texto diretamente em uma imagem finalizada, com suporte a resoluções de 1K a 4K, múltiplos níveis de qualidade e planejamento de complexidade, proporções de tela comuns e capacidade de saída em PNG, JPEG, WebP, SVG e GIF animado. É indicado para desenvolvedores que precisam gerar imagens rapidamente com custo baixo por imagem, produzir em volume ou integrar a geração de imagens em pipelines automatizados.

Destaques principais

Custo baixo por imagem, ideal para geração em volume — a cobrança é por imagem, com critério de preço simples, o que facilita a estimativa e a diluição do custo unitário em tarefas em lote.
Uma única chamada pode gerar vetores e animações — output_format suporta svg e gif, dispensando outras cadeias de ferramentas para materiais vetoriais e animações quadro a quadro.
Qualidade e complexidade ajustáveis de forma independente — quality controla o nível de renderização, enquanto complexity controla separadamente o nível de planejamento; textos densos e layouts complexos podem ser elevados conforme a necessidade.
Ampla cobertura de proporções e resoluções — oferece 16 proporções, de 1:1 a 21:9 e 3:1, além de três níveis de resolução de saída: 1K, 2K e 4K.

Descrição das capacidades

Geração direta de imagens a partir de texto: prompt é a única entrada obrigatória, com até 32000 caracteres, adequado para converter descrições estruturadas longas diretamente em imagens finais, sem necessidade de concatenação adicional de parâmetros.

Saída em múltiplos formatos, incluindo SVG e GIF: output_format suporta png, jpeg, webp, gif e svg; ao escolher gif, gera-se uma animação; ao escolher svg, obtém-se diretamente um arquivo vetorial, ampliando os tipos de ativos entregáveis.

Parâmetros quadro a quadro de GIF controláveis: é possível definir frame_size, frame_count (2 a 16 quadros) e frame_duration_ms, controlando com precisão o ritmo da animação e a proporção por dimensões em pixels e intervalo entre quadros.

Fundo transparente e saída comprimida: background pode ser definido como transparent e combinado com saída png ou webp para materiais com fundo transparente; em jpeg e webp, output_compression permite escolher entre tamanho e qualidade de imagem.

Camadas de qualidade, complexidade e resolução: quality oferece cinco níveis de renderização, de low a max; complexity controla independentemente a profundidade de planejamento; resolution pode ser 1K, 2K ou 4K, equilibrando velocidade e detalhe conforme o cenário.

Cenários de aplicação

Geração em volume para marketing e redes sociais — insira o tema da campanha ou a descrição do texto e gere imagens em lote nas proporções 16:9, 1:1 etc., prontas para uso em plataformas sociais e veiculação de materiais publicitários.
Geração de materiais vetoriais por equipes de design — use descrições de ícones e ilustrações como entrada para gerar arquivos SVG, entregues em ferramentas de design para edição posterior ou usados diretamente em páginas front-end.
Geração de materiais animados leves por desenvolvedores — gere GIFs com frame_count, frame_duration_ms e frame_size para demonstrações de produtos, animações de carregamento ou decoração de páginas de campanha.
Imagens programáticas em pipelines automatizados — chame a interface em sistemas de conteúdo ou scripts de build, montando prompt e parâmetros de resolução e formato a partir de modelos para complementar em lote as imagens de artigos ou produtos.

Limitações e recomendações de escolha

Esta rota trata apenas de geração de imagem a partir de texto; quando for necessário fazer modificações locais em imagens existentes ou gerar a partir de imagens de referência, deve-se usar a rota image-to-image da mesma série. A saída GIF tem limite total de quadros; dimensões de quadro muito grandes ou número excessivo de quadros são rejeitados pelo lado de submissão, e, em GIF, a proporção é determinada por frame_size, com aspect_ratio podendo ser apenas auto. O fundo transparente exige simultaneamente png ou webp, e, com output_compression, output_format deve ser especificado explicitamente. Se a consistência de detalhes em edições de múltiplas rodadas for mais importante, recomenda-se avaliar prioritariamente a variante Sunburst.

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-flare/text-to-image

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

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

promptstringObrigatóriominLength 1maxLength 32000

Descreva a imagem a ser gerada, com no máximo 32000 caracteres.

qualitystringOpcionalPadrão: "high"

Nível de qualidade de renderização; opções: low, medium, high, xhigh, max; se não informado, o padrão é high.

Opções:lowmediumhighxhighmax

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 imagens simples com um único elemento principal, high é adequado para texto denso e layouts complexos; se não informado, o padrão é high.

Opções:lowmediumhigh

frame_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; notações de proporção como 1:1 não são aceitas; se não informado ou definido como 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, a solicitação é rejeitada no envio e não é cobrada. 512x512 suporta 2–16 quadros; 768x768 suporta no máximo 12 quadros.

moderationstringOpcional

Nível de moderação de conteúdo; opções: auto ou low; se 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; se não informado, o padrão é 1K.

Opções:1K2K4K

frame_countintegerOpcionalPadrão: 9min 2max 16

Apenas para GIF: número de quadros, inteiro de 2–16; se não informado, o padrão é 9. Quando o tamanho do quadro é 768x768, o máximo é 12 quadros.

aspect_ratiostringOpcionalPadrão: "auto"

Proporção de saída; se não informado, o padrão é auto. O GIF não usa este parâmetro: se não informado ou definido como auto, use frame_size para controlar o tamanho e a proporção de cada quadro.

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, gif, svg; se não informado, o padrão é png. gif gera imagem animada e svg gera arquivo vetorial; esses dois formatos só suportam geração de imagem a partir de texto. Ao informar output_compression, é necessário informar também jpeg ou webp; ao informar qualquer um entre frame_size, frame_count e frame_duration_ms, é necessário informar gif.

Opções:pngjpegwebpgifsvg

frame_duration_msintegerOpcionalPadrão: 200min 20

Apenas para GIF: duração de exibição de cada quadro, em milissegundos, mínimo 20, arredondado para múltiplos de 10 milissegundos; se não informado, o padrão é 200.

output_compressionintegerOpcionalmin 0max 100

Nível de compressão de 0–100, usado apenas para jpeg ou webp; ao informar este parâmetro, é necessário definir output_format também como jpeg ou webp.

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-flare/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-flare/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-flare/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

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