Geração de imagens GPT-Image-2

• Modelo: gpt-image-2
• Endpoint: POST https://apimaster.ai/v1/images/generations
• Modo: Assíncrono — retorna task_id, depois consulte a tarefa
• Funcionalidades: Texto para imagem; imagem para imagem com até 16 imagens de referência (URL + base64 misturados)

Autenticação

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Parâmetros do corpo

Campo	Tipo	Obrigatório	Observações
model	string	sim	gpt-image-2
prompt	string	sim	Descrição da cena; moderação de segurança aplicada
n	integer	não	Apenas 1 (numérico, sem aspas)
size	string	não	Proporção de aspecto, padrão 1:1
resolution	string	não	1k / 2k / 4k, padrão 1k
image_urls	array	não	Imagens de referência → imagem para imagem
official_fallback	boolean	não	Fallback do canal oficial, padrão false

Valores de size

auto, 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21 ou strings de pixels como 3840x2160.

Resolução (pixels de amostra)

size	1k	2k	4k
1:1	1024×1024	2048×2048	2880×2880
16:9	1536×864	2048×1152	3840×2160

Todas as 15 proporções suportam 4K.

image_urls

• Máximo de 16 imagens
• URLs públicas e URIs de dados base64 podem ser misturadas
• Omita size para seguir a resolução de entrada; defina size para forçar a proporção de aspecto da saída

Exemplos

Texto para imagem mínimo

{
  "model": "gpt-image-2",
  "prompt": "An orange cat on a windowsill at sunset, watercolor"
}

16:9 @ 2K

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a corgi astronaut on the moon, cinematic",
    "size": "16:9",
    "resolution": "2k"
  }'

Resposta de envio

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA" }]
}

HTTP	Significado
400	Parâmetros inválidos
401	Chave de API inválida
402	Saldo insuficiente
429	Limite de taxa excedido

Consultar resultado da tarefa

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

URL da imagem: data.result.images[0].url[0]

status	Significado
submitted	Enfileirada
processing	Executando
completed	Pronta
failed	Veja o erro

Consulte após 10–20s, a cada 3–5s. Lote: POST https://apimaster.ai/v1/tasks/batch com {"task_ids":[...]}.

Observações

• Apenas assíncrono — nenhuma URL de imagem síncrona na resposta de criação.
• Prefira size para proporção de aspecto; evite repetir a proporção em prompt.
• Faturamento por nível de resolução; veja o console da sua conta.

Compare com o canal oficial.