Skip to content

MMEHDI0606/ai-agent-foundation-template / .agents/skills/ai-studio-image

ai-studio-image

Verified

Geracao de imagens humanizadas via Google AI Studio (Gemini). Fotos realistas estilo influencer ou educacional com iluminacao natural e imperfeicoes sutis.

FileKindSize
SKILL.mdskill md10.9 KB
references/prompt-engineering.mdmarkdown5.1 KB
references/setup-guide.mdmarkdown3.1 KB
scripts/config.pyscript25.0 KB
scripts/generate.pyscript21.9 KB
scripts/prompt_engine.pyscript17.2 KB
scripts/requirements.txtmanifest78 B
scripts/templates.pyscript19.3 KB

references/setup-guide.md

View on GitHub
# 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 |
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall