GPT Image

Os modelos GPT Image são úteis quando aderência ao prompt, renderização de texto, composição limpa ou grandes tamanhos de saída importam. A Pixapi os expõe através de endpoints de imagem compatíveis com OpenAI.

Superfície da API

Operação	Endpoint	Modo
Geração de imagens	POST /v1/images/generations	Síncrono
Tarefa de geração de imagens	POST /v1/async/images/generations	Assíncrono
Edição de imagens	POST /v1/images/edits	Síncrono
Tarefa de edição de imagens	POST /v1/async/images/edits	Assíncrono

IDs de modelo

ID do modelo	Melhor para
gpt-image-2	Níveis de qualidade OpenAI, tamanhos personalizados, saídas maiores e edição de imagens.
gpt-image-1.5	Geração e edição rápida de imagens GPT com forte renderização de texto.

Campos do GPT Image

Campo	Tipo	Obrigatório	Descrição
model	string	Sim	Use gpt-image-2 ou gpt-image-1.5.
prompt	string	Sim	Prompt de imagem, até o limite de prompt do modelo selecionado.
image	string ou string[]	Obrigatório para edição	URL da imagem de entrada, ou um array de URLs quando múltiplas referências forem suportadas.
n	number	Não	Número de imagens. Atualmente, apenas 1 é suportado.
size	string	Não	auto, popular preset sizes such as 1024x1024, 1536x1024, or 1024x1536, or a custom WIDTHxHEIGHT value.
quality	string	Não	low, medium, high ou auto quando suportado.

Tamanhos personalizados devem usar o formato WIDTHxHEIGHT, permanecer dentro dos limites do provedor e caber no nível de saída selecionado.

Preços

Modelo	Créditos por imagem
gpt-image-2	a partir de 1
gpt-image-1.5	a partir de 1

gpt-image-1.5 é cobrado apenas em tamanhos 1K (1024x1024, 1536x1024, 1024x1536 ou auto): low/medium/high é 1/4/14. Não oferece saídas 2K ou 4K.

Para gpt-image-2, os créditos seguem a matriz documentada de tamanho e qualidade. quality=auto é cobrado como high, e size=auto usa o nível 1K por padrão.

Nível de tamanho	Lado maior	low	medium	high / auto
1K	<= 1536px	1	4	14
2K	<= 2048px	2	17	67
4K	<= 3840px	4	34	133

O costCredits exibido para uma requisição é igual ao valor da matriz multiplicado por n.

Exemplo de geração

const response = await fetch('https://api.pixapi.ai/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'gpt-image-2',
    prompt: 'A clean SaaS hero image showing API model orchestration',
    n: 1,
    size: '1536x1024',
    quality: 'high',
  }),
});

const image = await response.json();

Exemplo de edição

curl https://api.pixapi.ai/v1/images/edits \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Replace the background with a bright studio setup",
    "image": "https://cdn.example.com/input.png",
    "size": "auto",
    "quality": "auto"
  }'

Resposta

{
  "created": 1766880000,
  "data": [
    {
      "url": "https://cdn.pixapi.ai/generated/gpt-image.png"
    }
  ]
}