Referênciav1.0.0 Estável

AI Image 2 API

Integre a geração de imagens e a edição por referência do GPT Image 2.0. Esta documentação cobre autenticação, os endpoints de geração e status, limites e cobrança.

https://gptimage2-ai.com

Início rápido

Conclua sua primeira chamada à API em apenas duas etapas: envie uma tarefa de geração e, em seguida, consulte o status.

Enviar tarefa

Envie uma requisição POST para o endpoint de geração para obter um ID de tarefa.

Consultar status

Use o ID de tarefa para verificar o progresso até obter a URL da imagem.

Autenticação

Observação: mantenha sua chave de API segura e não a exponha em código do lado do cliente.

Cabeçalho HTTP

Authorization: Bearer {YOUR_API_KEY}

POST

https://gptimage2-ai.com/api/generate

Cria uma nova tarefa de geração ou edição de imagem por referência. Este endpoint é assíncrono e retorna um task_id com status inicial; chame /api/status para obter as imagens finais.

This endpoint responds immediately with task_id. Poll /api/status until the status becomes SUCCESS to obtain image URLs.

Parâmetros do corpo

Nome do parâmetro	Tipo	Obrigatório	Descrição
`prompt`	string	Condicional	Prompt de texto descrevendo a imagem a criar (máx. 20000 caracteres). Obrigatório quando images está vazio.
`images`	string[]	Não	Array opcional de URLs de imagens de referência para edição ou recombinação em vez de geração pura por texto.
`aspect_ratio`	string	Não	Proporção de saída. Valores permitidos: auto, 1:1, 5:4, 9:16, 21:9, 16:9, 4:3, 3:2, 4:5, 3:4, 2:3.
`resolution`	string	Não	Resolução de saída: 1K (padrão), 2K ou 4K. 5:4 e 4:5 suportam apenas 1K; 1:1 não suporta 4K.

Resposta (JSON)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://gptimage2-ai.com/api/status

Consulta o status de execução e os resultados de uma tarefa.

Parâmetros de consulta

Nome do parâmetro	Obrigatório	Descrição
`task_id`	Sim	O ID retornado ao enviar a tarefa.

Exemplo de resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0"
    ],
    "consumed_credits": 10,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

Cobrança

Custo por imagem

10 créditos / imagem

Tarefas com falha não são cobradas. Outros modelos do site usam suas próprias taxas.

Tratamento de erros

401 UnauthorizedChave de API inválida
402 Payment RequiredSaldo insuficiente
429 Too Many RequestsMuitas requisições

Sobre o GPT Image 2.0

GPT Image 2.0 é o modelo de imagem por trás do AI Image 2. AI Image 2 é um serviço independente, sem afiliação, endosso ou patrocínio da OpenAI.

GPT Image 2.0 — geração fiel ao prompt com texto legível na imagem

GPT Image 2.0 segue instruções detalhadas com precisão, renderiza texto legível dentro das imagens e aceita fotos de referência para editar uma imagem existente.

Feito para tipografia, layouts e edição por referência

O modelo se sai bem em pôsteres, infográficos e mockups de UI onde o texto precisa ficar legível, e preserva o objeto em mudanças de estilo ou fundo quando há imagens de referência.

Pontos fortes

Texto legível na imagem — títulos, rótulos e slogans curtos dentro de pôsteres e infográficos.
Edição por referência — envie URLs de imagens para reestilizar ou recompor uma foto mantendo o objeto.
Layouts estruturados — composições com vários elementos como cardápios, panfletos e storyboards com painéis ordenados.
Saída de 1K a 4K — escolha 1K, 2K ou 4K; 4K indisponível em 1:1, e 5:4 / 4:5 apenas em 1K.
Onze proporções — auto, 1:1, 5:4, 9:16, 21:9, 16:9, 4:3, 3:2, 4:5, 3:4 e 2:3.
Preço fixo — cada imagem custa 10 créditos, cobrados apenas em caso de sucesso.

Como usar

promptprompt — descrição em linguagem natural; inclua o texto exato a ser renderizado (máx. 20000 caracteres).
imagesimages — array opcional de URLs de referência; o modelo as edita ou recombina.
resolutionresolution — 1K (padrão), 2K ou 4K; todos os tamanhos custam os mesmos 10 créditos.

GPT Image 2 prompts Examples