stability-ai — Генерация изображений с использованием AI-моделей

--- name: stability-ai description: Geracao de imagens via Stability AI (SD3.5, Ultra, Core). Text-to-image, img2img, inpainting, upscale, remove-bg, search-replace. 15 estilos artisticos. risk: safe source: community date_added: '2026-03-06' author: renat tags: - image-generation - stable-diffusion - ai-art - api tools: - claude-code - antigravity - cursor - gemini-cli - codex-cli --- # 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 ```bash ## 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