Usar com o n8n
Gere imagens em um fluxo do n8n com GPT Image ou Nano Banana pela API do Cheapest Imagen, usando o nó HTTP Request. Configurações, corpo da requisição e como salvar.
O n8n chama a API com o nó nativo HTTP Request. Você precisa de uma chave de API da sua conta.
1. Guarde a chave
No n8n, crie uma credencial do tipo Header Auth:
| Campo | Valor |
|---|---|
| Name | Authorization |
| Value | Bearer YOUR_KEY |
2. Gere a imagem
Adicione um nó HTTP Request:
| Configuração | Valor |
|---|---|
| Method | POST |
| URL | https://api.cheapestimagen.com/v1/images/generations |
| Authentication | Generic Credential Type, Header Auth, a credencial do passo 1 |
| Send Body | ativado, Body Content Type JSON |
| Options, Timeout | 420000 (uma imagem pode levar alguns minutos) |
Corpo:
{
"model": "nano-banana-2.1",
"prompt": "{{ $json.prompt }}",
"size": "1024x1024",
"response_format": "url"
}O nó devolve o link da imagem em data[0].url. Para usar o GPT Image, troque model por gpt-image-2 ou gpt-image-2.6; todos os ids estão na página de modelos.
3. Salve a imagem
Adicione um segundo nó HTTP Request:
| Configuração | Valor |
|---|---|
| Method | GET |
| URL | {{ $json.data[0].url }} |
| Options, Response, Response Format | File |
A saída é a imagem como dados binários, pronta para um nó de armazenamento, e-mail ou chat. O link funciona por 72 horas.
Edite uma imagem
Para alterar uma imagem existente, chame https://api.cheapestimagen.com/v1/images/edits com um corpo JSON que leve a imagem como link:
{
"model": "nano-banana-2.1",
"prompt": "{{ $json.prompt }}",
"images": [{ "image_url": "{{ $json.imageUrl }}" }],
"response_format": "url"
}Limites para planejar
Uma conta pode ter 50 requisições em andamento e enviar 300 por minuto. Em um loop sobre muitos itens, defina o tamanho do lote do nó como 50 ou menos. Veja Limites de uso e geração em lote.
Migrar da OpenAI
Passe o código que usa a API de Imagens da OpenAI para o Cheapest Imagen trocando só a URL base e a chave de API; os campos da requisição e da resposta continuam iguais.
Criar imagem POST
Cria uma ou mais imagens a partir de um prompt de texto. Os créditos são reservados quando a requisição começa e devolvidos por toda imagem que não for entregue.