API

GPT Image 2.5 API

Imagem

A API GPT Image 2.5 traz os modelos mais avançados da OpenAI para geração e edição de imagens ao seu aplicativo. Crie imagens a partir de texto ou edite imagens de referência, com proporções flexíveis e saída em 1K, 2K ou 4K. Escolha flare para geração rápida de imagens cotidianas de alta qualidade, ou sunburst para trabalhos criativos exigentes e edição precisa.

Autorizações

Bearerstringheaderobrigatório

Chave de API para autorizar solicitações

Corpo

application/json

modelstringobrigatório

gpt-image-2-5

input.promptstringobrigatório

Descreva a imagem que deseja criar, incluindo o tema, a composição, o estilo e a iluminação. Para editar imagens, indique o que deve ser alterado e preservado nas referências. Espaços no início e no fim são removidos.

input.modestringopcional

Selecione a variante do GPT Image 2.5. flare é o modo padrão e prioriza a velocidade para geração cotidiana de alta qualidade e iterações rápidas. sunburst prioriza requisitos de qualidade exigentes e precisão de edição, sendo indicado quando alterações exatas nas imagens de referência são essenciais.

Ambos os modos permitem geração de texto para imagem e edição de imagens. Omita input.images para gerar a partir de texto ou forneça referências para editar. Ao comparar os modos, mantenha o mesmo prompt, referências, proporção e resolução.

Padrão: flare

flaresunburst

input.imagesstring[]opcional

URLs opcionais de imagens de referência. Use apenas URLs HTTPS publicamente acessíveis. Omita este campo para gerar imagens a partir de texto.

input.aspect_ratiostringopcional

Proporção entre largura e altura da imagem de saída. auto permite que o modelo escolha uma composição adequada. Selecione uma proporção da lista para controlar o formato, como 1:1 para imagens quadradas, 9:16 para verticais ou 16:9 para horizontais.

Padrão: auto

auto1:12:33:23:44:39:1616:921:9

input.resolutionstringopcional

Nível de resolução de saída. Use os valores em letras minúsculas 1k, 2k ou 4k para selecionar o nível correspondente. Defina este campo explicitamente quando precisar de uma resolução específica.

Padrão: 2k

1k2k4k

Exemplos de requisição

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2-5",
  "input": {
    "prompt": "Uma foto de produto cinematográfica de uma câmera futurista em formato de banana"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "gpt-image-2-5",
    "status": "processing",
    "credits": 5
  }
}

Consulte este endpoint usando o ID da tarefa retornado até que a tarefa seja concluída ou falhe. Recomendamos consultar a cada 5 segundos para verificar o status mais recente.

POST /api/v1/check

{
  "task_id": "task_example"
}

Resposta

Status da tarefa retornado por POST /api/v1/check. Os IDs, URLs e horários abaixo são ilustrativos.

idstringobrigatório

Identificador da tarefa em data.id, igual ao task_id enviado na consulta.

statusstringobrigatório

completed indica que a geração foi bem-sucedida e data.data contém os resultados. Nos demais status, data.data é null.

failed_reasonstringopcional

Retornado somente quando status é failed, para explicar a falha. O campo é omitido em completed e processing.

Concluída · completed

Os URLs de download estão em data.data.results.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

Outros status

Em processing ou failed, data.data é null. Este exemplo mostra failed: somente failed inclui failed_reason. Continue consultando em processing; pare em failed.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

Consumo de créditos

Créditos consumidos por uma solicitação que gera uma imagem.

Créditos consumidos por uma solicitação que gera uma imagem.
Resolução	1K	2K	4K
Uma imagem	12	36	50

Sem parâmetros opcionais: 5 créditos

Envie explicitamente os parâmetros input indicados para usar a tarifa correspondente. Solicitações que geram várias imagens podem consumir mais créditos.

O campo credits retornado por POST /api/v1/create mostra os créditos cobrados pela tarefa.