stability-ai – skill Thiết kế & UI cho agent AI

Stability AI — Gerador de Imagens Profissional

Overview

Geracao de imagens via Stability AI (SD3.5, Ultra, Core). Text-to-image, img2img, inpainting, upscale, remove-bg, search-replace. 15 estilos artisticos.

When to Use This Skill

• When the user mentions "stability ai" or related topics
• When the user mentions "stable diffusion" or related topics
• When the user mentions "sd3.5" or related topics
• When the user mentions "gerar arte" or related topics
• When the user mentions "gerar ilustracao" or related topics
• When the user mentions "image to image" or related topics

Do Not Use This Skill When

• The task is unrelated to stability ai
• A simpler, more specific tool can handle the request
• The user needs general-purpose assistance without domain expertise

How It Works

Skill para gerar imagens artisticas e fotorrealistas usando a Stability AI API.

A API hospedada pode cobrar creditos. Licencas de pesos/modelos nao tornam a API gratuita; confirme precos e direitos atuais antes de enviar prompts/imagens.

Quando Usar Esta Skill Vs Ai-Studio-Image

| Cenario | Skill recomendada |

|---------|-------------------|

| Foto humanizada para Instagram/redes sociais | ai-studio-image |

| Arte digital, ilustracao, concept art | stability-ai |

| Foto com camera de celular (realismo casual) | ai-studio-image |

| Fotorrealismo cinematografico (8K, detalhado) | stability-ai |

| Material educacional com visual profissional | ai-studio-image |

| Poster, wallpaper, book cover, game asset | stability-ai |

| Inpainting (editar parte de uma imagem) | stability-ai |

| Upscale (aumentar resolucao) | stability-ai |

| Remover fundo de imagem | stability-ai |

| Search & Replace (trocar objeto em imagem) | stability-ai |

| Apagar elemento de uma imagem | stability-ai |

Setup Rapido

1. Criar conta em platform.stability.ai (gratuito)

2. Copiar API Key do dashboard

3. Colar no .env: STABILITY_API_KEY=sk-sua-chave-aqui

4. pip install -r scripts/requirements.txt

Detalhes completos em references/setup-guide.md.

1. Modos De Operacao

| Comando | O que faz | Endpoint |

|---------|-----------|----------|

| --mode generate | Texto para imagem (SD3.5) | /generate/sd3 |

| --mode ultra | Texto para imagem premium | /generate/ultra |

| --mode core | Texto para imagem rapido | /generate/core |

| --mode img2img | Imagem + texto para nova imagem | /generate/sd3 |

| --mode upscale | Aumentar resolucao (conservativo) | /upscale/conservative |

| --mode upscale-creative | Nao implementado neste helper (requer polling assincrono) | /upscale/creative |

| --mode remove-bg | Remover fundo (PNG transparente) | /edit/remove-background |

| --mode inpaint | Editar parte da imagem (mascara) | /edit/inpaint |

| --mode search-replace | Trocar objeto por descricao | /edit/search-and-replace |

| --mode erase | Apagar parte da imagem | /edit/erase |

2. Exemplos De Uso

## Geracao Basica (Sd 3.5 Large)

python scripts/generate.py --prompt "a serene mountain landscape at sunset" --mode generate

## Qualidade Maxima (Ultra)

python scripts/generate.py --prompt "cinematic portrait, dramatic lighting" --mode ultra --aspect-ratio 16:9

## Rapido Para Iteracao (Core)

python scripts/generate.py --prompt "cute cat ninja" --mode core --style anime

## Image-To-Image

python scripts/generate.py --prompt "watercolor style" --mode img2img --image foto.jpg --strength 0.7

## Upscale Conservativo

python scripts/generate.py --prompt "landscape photo" --mode upscale --image foto_pequena.jpg

## Remover Fundo

python scripts/generate.py --mode remove-bg --image produto.jpg

## Inpainting Com Mascara

python scripts/generate.py --prompt "red roses" --mode inpaint --image jardim.jpg --mask mascara.png

## Search & Replace

python scripts/generate.py --prompt "a golden retriever" --mode search-replace --image parque.jpg --search "the cat"

## Apagar Objeto

python scripts/generate.py --mode erase --image foto.jpg --mask area.png

## Listar Modelos

python scripts/generate.py --list-models

## Listar Estilos

python scripts/generate.py --list-styles

## Analisar Prompt (Sugestoes Automaticas)

python scripts/generate.py --prompt "anime warrior girl, widescreen" --analyze --json

3. Aspect Ratios

| Nome | Ratio | Aliases | Uso tipico |

|------|-------|---------|-----------|

| square | 1:1 | ig, instagram, quadrado | Feed Instagram |

| portrait | 2:3 | retrato, pinterest | Retrato, poster |

| landscape | 3:2 | paisagem, horizontal | Paisagem, banner |

| photo | 4:5 | ig-feed | Instagram feed otimizado |

| wide | 16:9 | widescreen, youtube, cinema, wallpaper | Cinema, YT |

| ultrawide | 21:9 | — | Monitor ultrawide |

| stories | 9:16 | vertical, tiktok, ig-stories | Stories, Reels |

| phone | 9:21 | — | Wallpaper celular |

4. Estilos (15 Presets)

Cada estilo adiciona qualificadores automaticamente ao prompt:

| Estilo | Descricao | Ideal para |

|--------|-----------|-----------|

| photorealistic | Fotorrealismo cinematografico | Retratos, cenas |

| anime | Anime/Manga japones | Personagens, cenas |

| digital-art | Arte digital detalhada | Ilustracoes gerais |

| oil-painting | Pintura a oleo classica | Arte classica |

| watercolor | Aquarela fluida | Arte delicada |

| pixel-art | Pixel art retro 8/16-bit | Games retro |

| 3d-render | Render 3D fotorrealista | Produtos, cenas 3D |

| concept-art | Concept art profissional | Games, filmes |

| comic | Comics/HQ estilizado | Quadrinhos |

| minimalist | Minimalista limpo | Design, logos |

| fantasy | Fantasy art epico | RPG, medieval |

| sci-fi | Sci-fi futurista | Cyberpunk, espaco |

| sketch | Desenho a lapis/carvao | Estudos, rascunhos |

| pop-art | Pop art vibrante | Arte moderna |

| noir | Film noir dramatico | Atmosfera sombria |

5. Output

Imagens salvas em data/outputs/ com naming: {mode}_{style}_{timestamp}_{index}.png

Metadados salvos em .meta.json com: prompt original, prompt final, modelo, aspect ratio, seed, tempo, tamanho.

Integracao Com Outras Skills

• ai-studio-image: Complementar — Stability AI para arte, Gemini para fotos humanizadas
• instagram: Gerar arte → publicar no Instagram
• telegram: Gerar imagem → enviar via bot

Rate Limits & Seguranca

• Quotas e precos sao definidos pelo servico e pela conta; nao deduza da Community License.
• Contador local de imagens (padrao 100/dia): informativo, sem atomicidade entre processos e sem garantia de teto financeiro. Execute uma geracao por vez.
• Retry limitado somente em 429; falhas ambiguas de POST nao sao reenviadas automaticamente.
• Fallback de API keys (primaria + backups)

Referencia De Arquivos

| Arquivo | Quando consultar |

|---------|-----------------|

| references/setup-guide.md | Setup inicial, API key, troubleshooting |

| references/prompt-engineering.md | Tecnicas avancadas de prompt |

| references/api-reference.md | Endpoints, parametros, respostas, erros |

Best Practices

• Provide clear, specific context about your project and requirements
• Review all suggestions before applying them to production code
• Combine with other complementary skills for comprehensive analysis

Common Pitfalls

• Using this skill for tasks outside its domain expertise
• Applying recommendations without understanding your specific context
• Not providing enough project context for accurate analysis

Related Skills

• ai-studio-image - Complementary skill for enhanced analysis
• comfyui-gateway - Complementary skill for enhanced analysis
• image-studio - Complementary skill for enhanced analysis

Limitations

• Prompts, imagens e mascaras sao enviados a Stability AI e podem gerar custos. Confirme selecao de arquivos e processamento externo dentro do pedido; criacao nao autoriza publicacao ou envio a redes sociais.
• --list-models mostra uma tabela local; nao autentica a chave nem verifica disponibilidade. Metadados salvos incluem prompts e caminhos privados: trate outputs como dados sensiveis.
• Modos inpaint/erase exigem mascara explicita no helper; creative upscale nao foi implementado.
• Use this skill only when the task clearly matches the scope described above.
• Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
• Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.