Gerar imagens com Auteo
Usa a CLI auteo (npm i -g @auteo/cli, depois auteo auth login). Se um comando sair com código 3, siga a habilidade auteo-conta para fazer login primeiro. Usuários MCP podem fazer o mesmo com as ferramentas auteo_* listadas no final.
1. Escolher um modelo
auteo model list --type text_to_image --json # ou --type image_to_image para edições
auteo model get <model> --json # todos os parâmetros, opções e restrições
Sempre leia model get antes de gerar: as proporções e níveis de resolução diferem por modelo, e resolutionsByAspectRatio indica quais níveis cada proporção permite.
Guia aproximado (verifique a lista ao vivo, pois muda):
| Necessidade | Boa primeira escolha |
|---|---|
| Melhor qualidade geral, texto em imagens | openai/gpt-image-2-6-sunburst, google/nano-banana-pro |
| Rascunhos rápidos e baratos | google/nano-banana, alibaba/z-image |
| Editar uma foto com imagens de referência | google/nano-banana-2, bytedance/seedream-5-5 |
| Gratuito para assinantes Plus / Ultra | modelos com subscriberUnlimited: true (ex.: alibaba/z-image) |
2. Escolher parâmetros
--aspect-ratioé obrigatório. Use o que o usuário solicitou; caso contrário,1:1para avatares e ícones,16:9para banners e thumbnails,9:16para stories,3:4para retratos. Alguns modelos também oferecemauto.--resolutioné obrigatório quando o modelo tem níveis (1K/2K/4K). Níveis mais altos custam mais. Padrão para1Kem rascunhos; só aumente quando o usuário quiser impressão ou tela grande, e avise que custa mais.--n(1–4) gera várias variações; cada uma é cobrada.--image <caminho|url-https>(repetível) adiciona imagens de referência para edição ou estilo. Arquivos locais são enviados; o número permitido está emmodel get(inputAssetIds.max).- Escreva o prompt em inglês, a menos que o usuário queira texto em outro idioma renderizado na imagem.
3. Verificar o preço, depois gerar
auteo generate cost google/nano-banana-2 --aspect-ratio 16:9 --resolution 2K --json
auteo generate create google/nano-banana-2 --prompt "uma raposa vermelha na neve fresca, iluminação cinematográfica" \
--aspect-ratio 16:9 --resolution 2K --out ./images --json
--out <dir> aguarda o resultado e baixa os arquivos; o JSON lista files e outputs[].url. Sem --out/--wait, o comando retorna um requestId imediatamente; busque-o depois com auteo generate wait <requestId> --out ./images.
Informe ao usuário os caminhos dos arquivos e os créditos gastos (cost).
Quando falha
- Saída 4, créditos insuficientes: pare e siga a habilidade auteo-conta (informe ao usuário o preço e o saldo, link para recarregar). Não reduza as configurações por conta própria.
- Saída 2, parâmetros inválidos: releia
auteo model get <model>e corrija a combinação de proporção/nível. - Saída 5, prompt rejeitado pela moderação: reescreva o prompt sem o conteúdo sinalizado; reenviar o mesmo prompt falhará novamente.
- Saída 6, limite: muitas gerações em andamento ou muitas submissões; aguarde e tente novamente.
- Timeout ou erro de rede durante
create: não reenvie cegamente. Executeauteo generate list --type image --limit 5 --json; se a requisição não estiver lá, tente novamente com--client-request-id <o id impresso antes>para que não seja cobrada duas vezes. status: failedno resultado: informeerrorMessage; sesuggestedModelestiver definido, ofereça-o ao usuário.
Ferramentas MCP
auteo_list_models, auteo_get_model, auteo_estimate_cost, auteo_upload_image (retorna um assetId para inputAssetIds), auteo_generate_image, auteo_get_generation (chame novamente após pollAfterMs até done), auteo_list_generations.