Generar imágenes con Auteo
Usa la CLI auteo (npm i -g @auteo/cli, luego auteo auth login). Si un comando termina con código 3, sigue la habilidad auteo-account para iniciar sesión primero. Los usuarios de MCP pueden hacer lo mismo con las herramientas auteo_* listadas al final.
1. Elegir un modelo
auteo model list --type text_to_image --json # o --type image_to_image para ediciones
auteo model get <model> --json # todos los parámetros, opciones y restricciones
Siempre lee model get antes de generar: las relaciones de aspecto y los niveles de resolución varían según el modelo, y resolutionsByAspectRatio indica qué niveles permite cada relación.
Guía aproximada (consulta la lista en vivo, cambia):
| Necesidad | Buena primera opción |
|---|---|
| Mejor calidad general, texto en imágenes | openai/gpt-image-2-6-sunburst, google/nano-banana-pro |
| Borradores rápidos y baratos | google/nano-banana, alibaba/z-image |
| Editar una foto con imágenes de referencia | google/nano-banana-2, bytedance/seedream-5-5 |
| Gratuito para suscriptores Plus / Ultra | modelos con subscriberUnlimited: true (ej. alibaba/z-image) |
2. Elegir parámetros
--aspect-ratioes obligatorio. Usa lo que pida el usuario; de lo contrario,1:1para avatares e iconos,16:9para banners y miniaturas,9:16para historias,3:4para retratos. Algunos modelos también ofrecenauto.--resolutiones obligatorio cuando el modelo tiene niveles (1K/2K/4K). Los niveles más altos cuestan más. Por defecto usa1Kpara borradores; solo sube a niveles superiores si el usuario quiere impresión o pantalla grande, e indica que cuesta más.--n(1–4) genera varias variantes; cada una se cobra.--image <ruta|https-url>(repetible) añade imágenes de referencia para editar o estilo. Los archivos locales se suben; la cantidad permitida está enmodel get(inputAssetIds.max).- Escribe el prompt en inglés a menos que el usuario quiera texto en otro idioma renderizado en la imagen.
3. Consultar el precio, luego generar
auteo generate cost google/nano-banana-2 --aspect-ratio 16:9 --resolution 2K --json
auteo generate create google/nano-banana-2 --prompt "un zorro rojo en nieve fresca, luz cinematográfica" \
--aspect-ratio 16:9 --resolution 2K --out ./images --json
--out <dir> espera el resultado y descarga los archivos; el JSON lista files y outputs[].url. Sin --out/--wait el comando devuelve un requestId inmediatamente; recupéralo después con auteo generate wait <requestId> --out ./images.
Informa al usuario las rutas de los archivos y los créditos gastados (cost).
Cuando falla
- Código 4, créditos insuficientes: detente y sigue la habilidad auteo-account (informa al usuario el precio y saldo, enlace para recargar). No reduzcas la configuración por tu cuenta.
- Código 2, parámetros inválidos: vuelve a leer
auteo model get <model>y corrige la combinación de relación / nivel. - Código 5, prompt rechazado por moderación: reescribe el prompt sin el contenido marcado; reenviar el mismo prompt fallará de nuevo.
- Código 6, límite: demasiadas generaciones en curso o demasiadas solicitudes; espera y reintenta.
- Timeout o error de red durante
create: no reenvíes a ciegas. Ejecutaauteo generate list --type image --limit 5 --json; si la solicitud no está ahí, reintenta con--client-request-id <el id impreso antes>para que no se cobre dos veces. status: faileden el resultado: reportaerrorMessage; sisuggestedModelestá definido, ofrécelo al usuario.
Herramientas MCP
auteo_list_models, auteo_get_model, auteo_estimate_cost, auteo_upload_image (devuelve un assetId para inputAssetIds), auteo_generate_image, auteo_get_generation (llama de nuevo después de pollAfterMs hasta que esté done), auteo_list_generations.