SKILL.md
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. Gratuito com Community License (sem limite para uso pessoal/pequenas empresas).
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
- Criar conta em platform.stability.ai (gratuito)
- Copiar API Key do dashboard
- Colar no
.env:STABILITYAPIKEY=sk-sua-chave-aqui 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 |
Aumentar resolucao com detalhes | /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 --json3. 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
- Community License: 150 requests/10 segundos
- Limite diario: 100 imagens/dia (configuravel via
SAFETYMAXIMAGESPERDAY) - Retry automatico com backoff exponencial em caso de 429
- 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 analysiscomfyui-gateway- Complementary skill for enhanced analysisimage-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.