pollinations-image-gen

Gere imagens com IA de graça e sem precisar de API key, usando a API pública da Pollinations.ai.

Instalação

Copie a pasta do módulo para o seu projeto e instale (não há dependências externas, só o Node.js):

npm install

Requer Node.js 18+ (usa fetch nativo).

Uso rápido

const { generateImage, generateImageToFile } = require('./index.js');

// Gerar e salvar direto em arquivo
await generateImageToFile('um gato astronauta no espaço', './saida.png');

// Ou gerar e receber o Buffer (útil pra enviar em bots do Discord/Telegram/WhatsApp)
const buffer = await generateImage('um dragão de cristal em uma floresta mágica');

API

generateImage(prompt, options?) → Promise<Buffer>

Gera uma imagem e retorna o Buffer (não salva em disco).

generateImageToFile(prompt, outputPath, options?) → Promise<string>

Gera uma imagem e salva em disco. Retorna o caminho absoluto do arquivo salvo.

Opções (options)

| Opção | Tipo | Padrão | Descrição | |-----------|-----------|----------|--------------------------------------------------------------------| | width | number | 1024 | Largura da imagem em pixels | | height | number | 1024 | Altura da imagem em pixels | | model | string | 'flux' | Modelo de geração (veja MODELS abaixo) | | seed | number | — | Seed fixa, útil para reproduzir a mesma imagem depois | | nologo | boolean | true | Remove a marca d'água da Pollinations | | enhance | boolean | false | Deixa a IA melhorar automaticamente o seu prompt antes de gerar | | timeout | number | 60000 | Tempo máximo de espera em milissegundos |

Modelos disponíveis (MODELS)

['flux', 'flux-realism', 'flux-anime', 'flux-3d', 'turbo']

A lista de modelos pode mudar com o tempo, já que depende do serviço da Pollinations.

Exemplo completo

Veja example.js:

node example.js

Usando em um bot (Discord/Telegram/WhatsApp)

Como generateImage() retorna um Buffer, você pode enviar direto sem salvar em disco:

const { generateImage } = require('./index.js');

// Exemplo genérico
const buffer = await generateImage('um sapo mago lançando um feitiço');
// discordChannel.send({ files: [{ attachment: buffer, name: 'imagem.png' }] });

Tratamento de erros

O módulo lança Error em caso de:

• Prompt vazio ou inválido
• Falha HTTP (status diferente de 2xx)
• Timeout excedido

try {
  const buffer = await generateImage('...');
} catch (err) {
  console.error('Falha ao gerar imagem:', err.message);
}

Aviso

Este módulo depende de um serviço público de terceiros (Pollinations.ai) que pode ter instabilidades, limites de uso informais ou mudanças na API sem aviso prévio. Não há garantia de SLA — é uma opção gratuita, ideal para projetos pessoais, bots e protótipos.

Licença

MIT