OpenAI

GPT Image 2.5

gpt-image-2.5-flare/image-to-image

Modelo de geração e edição de imagens da OpenAI com dois níveis: Flare focado em velocidade e Sunburst em precisão, atendendo tanto à geração de imagens a partir de texto quanto à edição iterativa de imagens

Rota

default pro

gpt-image-2.5-flare/image-to-image gpt-image-2.5-flare/text-to-image gpt-image-2.5-sunburst/image-to-image gpt-image-2.5-sunburst/text-to-image

Experimentar gpt-image-2.5-flare/image-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.5-flare/image-to-image per image

Especificações	Preço unitário
1K	$0.050
2K	$0.080
4K	$0.120

Visão geral do posicionamento

gpt-image-2.5-flare/image-to-image é a interface voltada à edição de imagens na família de modelos de imagem da OpenAI: recebe de uma a dezesseis imagens de referência e uma instrução de edição, e produz uma única imagem final. Em comparação com o Sunburst, o Flare prioriza o equilíbrio entre velocidade e qualidade de imagem, sendo adequado para aplicações que exigem geração rápida ou processamento em lote. Desenvolvedores podem chamá-lo pela interface unificada do HiAPI.ai, escolhendo entre resoluções de 1K a 4K e diversas proporções de tela, com suporte também a saída com fundo transparente, ideal para tarefas de transformação de imagens como materiais de e-commerce, visuais de marca e retoque de design.

Destaques principais

Entrada com múltiplas imagens de referência, até 16 — uma única requisição pode carregar até 16 imagens de origem ou referência, facilitando a fusão de vários materiais ou a fixação do sujeito e do layout.
Fundo transparente limitado ao nível 1K — o modo de fundo oferece três opções: transparente, opaco e automático, mas só está disponível em resolução 1K; em 2K e 4K é preciso omitir esse parâmetro.
Resolução e proporção selecionáveis — a saída suporta três níveis (1K, 2K, 4K) e treze proporções de tela, com proporção automática por padrão, podendo ser predefinida conforme o local de veiculação.
Flare prioriza o equilíbrio entre velocidade e qualidade — na mesma família há também a versão Sunburst, voltada à precisão; o Flare é mais adequado a fluxos de edição rotineiros com exigências de tempo de resposta.

Descrição das capacidades

Edição com múltiplas referências: aceita até 16 imagens JPEG, PNG ou WebP, junto com uma instrução de até vinte mil caracteres descrevendo o objetivo da transformação, ideal para redesenhar a cena preservando o sujeito e o layout de referência.

Controle de resolução e proporção: permite especificar os níveis de saída 1K, 2K e 4K e escolher entre proporções como 1:1, 16:9, 9:16 e 21:9, reduzindo o custo de recorte no pós-processamento e alinhando a saída diretamente ao tamanho de veiculação.

Alternância do modo de fundo: em resolução 1K, o fundo pode ser definido como transparente, opaco ou automático; a saída transparente facilita a entrada direta em fluxos de composição e diagramação, reduzindo a etapa de recorte.

Revisão refinada por instruções: graças à cota mais longa de prompt e à aderência a instruções visuais complexas, é possível fazer substituições locais, ajustes de estilo e retoques de detalhes sobre imagens existentes, adequado a fluxos de edição iterativos.

Cenários de aplicação

Operação de e-commerce: transformação de materiais em lote a partir de fotos de produtos — insira fotos reais do produto e instruções de edição para gerar visuais do produto em vários tamanhos e proporções, usados em páginas de detalhes, imagens principais e materiais de veiculação.
Marketing de marca: composição de visuais com múltiplas referências — combine várias imagens de referência para gerar rascunhos visuais com estilo unificado, usados na validação inicial de propostas, apresentações e imagens para sites.
Colaboração de design: retoque iterativo sobre layouts existentes — use o design atual como entrada para modificar sujeito, iluminação e fundo rodada após rodada, gerando imagens prontas para a diagramação seguinte.
Produção de materiais: saída de imagens com fundo transparente — gere elementos com fundo transparente no nível 1K para ícones, adesivos e bibliotecas de composição, dispensando etapas extras de recorte.

Limitações e recomendações de escolha

Esta interface faz apenas edição de imagens e exige pelo menos uma imagem de origem; não gera a partir de texto puro. O modo de fundo só funciona no nível 1K; em 2K e 4K é preciso omitir esse parâmetro. Layouts com muito texto em corpo pequeno ou legendas complexas ainda tendem a apresentar erros e exigem revisão humana. Quando for necessário maior fidelidade de detalhes e for aceitável esperar mais, pode-se optar pela linha Sunburst; quando for preciso gerar a partir de texto puro, use a linha text-to-image correspondente. Saídas em alta resolução aumentam o custo computacional e o tempo de espera.

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

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

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

promptstringObrigatóriominLength 1maxLength 20000

Instrução de geração ou edição, usada para descrever o conteúdo a ser gerado ou editado com base na imagem de origem, com no máximo 20000 caracteres.

backgroundstringOpcional

Modo de fundo, suportado apenas na resolução 1K; ao usar resoluções 2K/4K, omita este parâmetro.

Opções:transparentopaqueauto

image_urlsarrayObrigatóriominItems 1maxItems 16

Array de imagens de origem ou de referência, com suporte a 1 a 16 imagens, nos formatos JPEG, PNG ou WebP.

Array [ string ]

resolutionstringOpcionalPadrão: "1K"

Nível de resolução de saída, padrão 1K; quando background for auto, opaque ou transparent, apenas 1K é suportado.

Opções:1K2K4K

aspect_ratiostringOpcionalPadrão: "auto"

Proporção de aspecto da saída; quando omitida, o padrão é auto.

Opções:auto1:13:22:34:33:416:99:16

Mostrar tudo (5)

21:927:1616:279:88:9

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.5-flare/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "1K",
    "aspect_ratio": "auto"
  }
}'

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.5-flare/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "1K",
      "aspect_ratio": "auto"
    }
  }),
});
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.5-flare/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "1K",
          "aspect_ratio": "auto"
        }
    },
)
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"
    }
  }
}