antigravity-awesome-skills/plugins/antigravity-awesome-skills-claude/skills/ai-studio-image/references/setup-guide.md

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