FrancoStino/stability-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. 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

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

• 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

| 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

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