Files
antigravity-skills-reference/skills/ai-studio-image/references/setup-guide.md
ProgramadorBrasil 61ec71c5c7 feat: add 52 specialized AI agent skills (#217)
New skills covering 10 categories:

**Security & Audit**: 007 (STRIDE/PASTA/OWASP), cred-omega (secrets management)
**AI Personas**: Karpathy, Hinton, Sutskever, LeCun (4 sub-skills), Altman, Musk, Gates, Jobs, Buffett
**Multi-agent Orchestration**: agent-orchestrator, task-intelligence, multi-advisor
**Code Analysis**: matematico-tao (Terence Tao-inspired mathematical code analysis)
**Social & Messaging**: Instagram Graph API, Telegram Bot, WhatsApp Cloud API, social-orchestrator
**Image Generation**: AI Studio (Gemini), Stability AI, ComfyUI Gateway, image-studio router
**Brazilian Domain**: 6 auction specialist modules, 2 legal advisors, auctioneers data scraper
**Product & Growth**: design, invention, monetization, analytics, growth engine
**DevOps & LLM Ops**: Docker/CI-CD/AWS, RAG/embeddings/fine-tuning
**Skill Governance**: installer, sentinel auditor, context management

Each skill includes:
- Standardized YAML frontmatter (name, description, risk, source, tags, tools)
- Structured sections (Overview, When to Use, How it Works, Best Practices)
- Python scripts and reference documentation where applicable
- Cross-platform compatibility (Claude Code, Antigravity, Cursor, Gemini CLI, Codex CLI)

Co-authored-by: ProgramadorBrasil <214873561+ProgramadorBrasil@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-07 10:04:07 +01:00

103 lines
3.1 KiB
Markdown

# AI Studio Image — Guia de Setup Completo
## 1. Obter API Key
1. Acesse https://aistudio.google.com/apikey
2. Clique em "Create API Key"
3. Selecione ou crie um projeto Google Cloud
4. Copie a key gerada
## 2. Configurar API Key
### Opcao A: Arquivo .env (recomendado)
Crie/edite `C:\Users\renat\skills\ai-studio-image\.env`:
```
GEMINI_API_KEY=sua-api-key-principal
GEMINI_API_KEY_BACKUP_1=key-backup-1
GEMINI_API_KEY_BACKUP_2=key-backup-2
```
### Opcao B: Variavel de ambiente
```bash
# Windows CMD
set GEMINI_API_KEY=sua-api-key
# Windows PowerShell
$env:GEMINI_API_KEY="sua-api-key"
# Linux/Mac
export GEMINI_API_KEY=sua-api-key
```
## 3. Instalar Dependencias
```bash
pip install -r C:\Users\renat\skills\ai-studio-image\scripts\requirements.txt
```
Ou manualmente:
```bash
pip install google-genai Pillow python-dotenv
```
## 4. Teste Rapido
```bash
# Testar se tudo funciona
python C:\Users\renat\skills\ai-studio-image\scripts\generate.py --list-models
# Gerar primeira imagem
python C:\Users\renat\skills\ai-studio-image\scripts\generate.py \
--prompt "pessoa jovem sorrindo em cafeteria" \
--mode influencer \
--format square
```
## 5. Modelos Disponiveis
| Modelo | ID | Velocidade | Qualidade | Custo | Melhor Para |
|--------|-----|-----------|-----------|-------|-------------|
| imagen-4 | imagen-4.0-generate-001 | Medio | Alta | $0.03 | **Uso geral (recomendado)** |
| imagen-4-ultra | imagen-4.0-ultra-generate-001 | Lento | Maxima | $0.06 | Alta qualidade, impressao |
| imagen-4-fast | imagen-4.0-fast-generate-001 | Rapido | Boa | $0.02 | Volume alto, iteracao rapida |
| gemini-flash-image | gemini-2.5-flash-preview-image-generation | Rapido | Alta | Var. | Edicao, multi-turn |
| gemini-pro-image | gemini-3-pro-image-preview | Medio | Maxima+4K | Var. | Texto, referencia, 4K |
## 6. Formatos (Aspect Ratios)
| Nome | Ratio | Uso |
|------|-------|-----|
| square | 1:1 | Feed Instagram/Facebook |
| portrait-45 | 4:5 | Instagram portrait (melhor!) |
| portrait-34 | 3:4 | Pinterest, cards |
| portrait-23 | 2:3 | Posters, prints |
| widescreen | 16:9 | YouTube, banners |
| ultrawide | 21:9 | Cinematico |
| stories | 9:16 | Stories, Reels, TikTok |
| landscape-43 | 4:3 | Apresentacoes |
| landscape-32 | 3:2 | Fotografia 35mm |
| landscape-54 | 5:4 | Quase-quadrado |
## 7. Niveis de Humanizacao
| Nivel | Descricao | Quando Usar |
|-------|-----------|-------------|
| ultra | Parece celular amador | Conteudo muito casual, BTS |
| natural | Celular moderno, equilibrado | **Padrao — maioria dos casos** |
| polished | Natural mas caprichado | Conteudo profissional |
| editorial | Estilo revista | Branding, editorial |
## 8. Troubleshooting
| Erro | Causa | Solucao |
|------|-------|---------|
| API key not found | Sem key configurada | Crie .env ou set variavel |
| 403 Forbidden | Key sem permissao | Verifique permissoes no Google Cloud |
| 429 Rate Limited | Muitas requisicoes | Aguarde ou use key backup |
| Image blocked | Conteudo restrito | Ajuste prompt, evite conteudo sensivel |
| Model not found | Modelo indisponivel | Tente outro modelo: imagen-4 |
| Empty response | Prompt muito generico | Adicione mais detalhes ao prompt |