AI Studio Image — Guia de Setup Completo
1. Obter API Key
- Acesse https://aistudio.google.com/apikey
- Clique em "Create API Key"
- Selecione ou crie um projeto Google Cloud
- 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 |