ai-studio-image - setup-guide

发布时间：2026/10/24 5:21:54
ai-studio-image - setup-guide

AI Studio 图像 — 完整设置指南

1. 获取 API 密钥

  1. 访问 https://aistudio.google.com/apikey
  2. 点击“创建 API 密钥”
  3. 选择或创建一个 Google Cloud 项目
  4. 复制生成的密钥

2. 设置 API 密钥

选项 A：.env 文件（推荐）

创建/编辑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

选项 B：环境变量

# Windows CMDsetGEMINI_API_KEY=sua-api-key# Windows PowerShell$env:GEMINI_API_KEY="sua-api-key"# Linux/MacexportGEMINI_API_KEY=sua-api-key

3. 安装依赖

pipinstall-rC:\Users\renat\skills\ai-studio-image\scripts\requirements.txt

或者手动:

pipinstallgoogle-genai Pillow python-dotenv

4. 快速测试

# Testar se tudo funcionapython C:\Users\renat\skills\ai-studio-image\scripts\generate.py --list-models# Gerar primeira imagempython C:\Users\renat\skills\ai-studio-image\scripts\generate.py\--prompt"pessoa jovem sorrindo em cafeteria"\--modeinfluencer\--formatsquare

5. 可用型号

ModeloIDVelocidadeQualidadeCustoMelhor Para
imagen-4imagen-4.0-generate-001MedioAlta$0.03Uso geral (recomendado)
imagen-4-ultraimagen-4.0-ultra-generate-001LentoMaxima$0.06Alta qualidade, impressao
imagen-4-fastimagen-4.0-fast-generate-001RapidoBoa$0.02Volume alto, iteracao rapida
gemini-flash-imagegemini-2.5-flash-preview-image-generationRapidoAltaVar.Edicao, multi-turn
gemini-pro-imagegemini-3-pro-image-previewMedioMaxima+4KVar.Texto, referencia, 4K

6. 格式（纵横比）

NomeRatioUso
square1:1Feed Instagram/Facebook
portrait-454:5Instagram portrait (melhor!)
portrait-343:4Pinterest, cards
portrait-232:3Posters, prints
widescreen16:9YouTube, banners
ultrawide21:9Cinematico
stories9:16Stories, Reels, TikTok
landscape-434:3Apresentacoes
landscape-323:2Fotografia 35mm
landscape-545:4Quase-quadrado

7. 人性化水平

NivelDescricaoQuando Usar
ultraParece celular amadorConteudo muito casual, BTS
naturalCelular moderno, equilibradoPadrao — maioria dos casos
polishedNatural mas caprichadoConteudo profissional
editorialEstilo revistaBranding, editorial

8. 故障排除

ErroCausaSolucao
API key not foundSem key configuradaCrie .env ou set variavel
403 ForbiddenKey sem permissaoVerifique permissoes no Google Cloud
429 Rate LimitedMuitas requisicoesAguarde ou use key backup
Image blockedConteudo restritoAjuste prompt, evite conteudo sensivel
Model not foundModelo indisponivelTente outro modelo: imagen-4
Empty responsePrompt muito genericoAdicione mais detalhes ao prompt