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

3.1 KiB

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

# 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

pip install -r C:\Users\renat\skills\ai-studio-image\scripts\requirements.txt

Ou manualmente:

pip install google-genai Pillow python-dotenv

4. Teste Rapido

# 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