stability-ai

Stability AI — Gerador de Imagens Profissional

Selective Reading Rule

Start with:

• references/usage-routing.md
• references/quality-checklist.md

Then load only the inherited docs, scripts, assets, or examples that match the user's actual task.

Selective Reading Rule

Start with:

• references/senior-master-standard.md

Then load only the references, scripts, assets, or examples needed for the user's actual task.

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. Gratuito com Community License (sem limite para uso pessoal/pequenas empresas).

Quando Usar Esta Skill Vs Ai-Studio-Image

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

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

4. Estilos (15 Presets)

Cada estilo adiciona qualificadores automaticamente ao prompt:

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

• Community License: 150 requests/10 segundos
• Limite diario: 100 imagens/dia (configuravel via SAFETY_MAX_IMAGES_PER_DAY)
• Retry automatico com backoff exponencial em caso de 429
• Fallback de API keys (primaria + backups)

Referencia De Arquivos

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

• 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.