Geração de imagens GPT-Image-2

gpt-image-2 suporta geração e edição de imagens de referência para imagens de produtos, rascunhos de pôsteres, ilustrações, materiais sociais, visuais de alta resolução, transferência de estilo e fusão de várias referências.

POST https://api.apihop.ai/openai/v1/images/generations

Autenticação

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Início rápido

{
  "model": "gpt-image-2",
  "prompt": "A minimal black wireless earbud product poster on a white background, clean studio lighting, no text",
  "n": 1,
  "size": "2048x1152",
  "resolution": "2k",
  "quality": "low"
}

Escopo da comparação de preços

As faixas de imagem 1K / 2K / 4K publicadas pela RequestBeam são *preços de venda da RequestBeam*, não tarifas oficiais fixas da OpenAI por imagem. A documentação de preços da OpenAI descreve cobranças de tokens de imagem/texto e níveis de processamento; o custo real depende de tamanho, qualidade, referências de entrada e saída. Comparar apenas porque ambos mencionam 1k ou 2k não é um cálculo de desconto em condições equivalentes.

Para evitar alegações de economia sem suporte, a antiga referência agregada de provedores USD per image e o selo de desconto estão intencionalmente ocultos para GPT Image 2. O preço RequestBeam permanece visível e seu contrato de cobrança não muda. Para uma comparação futura fundamentada, registre modelo exato, endpoint, qualidade, dimensões, condições de entrada, URL da fonte oficial e data da verificação. Confira o preço efetivo da sua conta antes de uma chamada paga.

Corpo da requisição

Imagens de referência e edição

A edição de imagens de referência usa o mesmo endpoint JSON. Adicione image_urls e descreva em prompt o que preservar e alterar:

{
  "model": "gpt-image-2",
  "prompt": "Keep the product unchanged, replace the background with a dark blue studio, and add soft rim lighting",
  "image_urls": [
    "https://example.com/product.png"
  ],
  "size": "1:1",
  "resolution": "2k"
}

Várias referências podem fornecer o assunto, a composição ou o estilo visual:

{
  "model": "gpt-image-2",
  "prompt": "Use the product from the first image and the composition from the second image to create a clean ecommerce hero image",
  "image_urls": [
    "https://example.com/product.png",
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  ],
  "size": "4:3",
  "resolution": "2k"
}

Limites atuais do contrato público:

• Edição da imagem inteira, transferência de estilo e fusão de referências são suportadas por image_urls.
• Não há uma rota separada POST https://api.apihop.ai/openai/v1/images/edits.
• Uploads multipart/form-data não são aceitos. Converta primeiro imagens locais em URIs de dados Base64 ou envie-as a URLs acessíveis.
• Inpainting com máscara não é suportado. Enviar mask, mask_url ou maskUrl retorna 400 antes da reserva.

Exemplos de requisição

Imagem de produto 1:1

{
  "model": "gpt-image-2",
  "prompt": "A transparent glass cup on a light gray background, commercial product photography, soft shadow, no text",
  "n": 1,
  "size": "1024x1024",
  "resolution": "1k",
  "quality": "low",
  "output_format": "png"
}

Pôster 16:9

{
  "model": "gpt-image-2",
  "prompt": "A futuristic city night poster with neon lights, wet streets, cinematic composition, no text",
  "n": 1,
  "size": "2048x1152",
  "resolution": "2k",
  "quality": "medium",
  "output_format": "jpeg"
}

Como os resultados são retornados

Este endpoint compatível com OpenAI não retorna primeiro uma resposta de envio de tarefa contendo data.jobId para consulta posterior:

• Com stream: false, a requisição HTTP atual aguarda a conclusão e retorna URLs de imagens na resposta JSON.
• Com stream: true, a conexão SSE atual permanece aberta até image_generation.completed e [DONE].

Não use GET https://api.apihop.ai/v1/jobs/{id} para obter resultados deste endpoint. Use Consultar tarefa assíncrona somente quando um endpoint de criação assíncrona retornar explicitamente um jobId.

Resposta sem streaming

A resposta contém URLs das imagens. usage é incluído quando a rota do provedor fornece informações de medição.

{
  "created": 1777270000,
  "data": [
    {
      "url": "https://image.example.com/generated/123456789012345678/0.png"
    }
  ],
  "usage": {
    "input_tokens": 20,
    "output_tokens": 1234,
    "total_tokens": 1254
  }
}

Resposta em streaming

event: image_generation.completed
data: {"type":"image_generation.completed","data":[{"index":0,"url":"https://image.example.com/generated/123456789012345678/0.png"}],"usage":{"input_tokens":20,"output_tokens":1234,"total_tokens":1254}}

data: [DONE]

Referência de dimensões

Resposta de erro

Consulte Códigos de erro e solução de problemas para a referência completa, diferenças de protocolo e etapas de diagnóstico.

{
  "code": 10000,
  "message": "prompt is required",
  "type": "api_error"
}

Erros comuns:

• 400: parâmetros obrigatórios ausentes ou combinação não suportada
• 401: autenticação falhou ou chave de API incorreta
• 402: saldo insuficiente
• 404: modelo inexistente ou não ativado
• 429: limite de taxa excedido
• 5xx: serviço temporariamente indisponível ou geração de imagem falhou