csh
/
playbook
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
playbook/antigravity-awesome-skills/skills/stability-ai/references/setup-guide.md

2.5 KiB
Raw Blame History

Setup Guide — Stable Diffusion Skill

1. Criar Conta na Stability AI

  1. Acesse https://platform.stability.ai
  2. Clique em Sign Up (ou Login se ja tem conta)
  3. Pode usar Google, GitHub ou email/senha
  4. A Community License e gratuita e automatica para uso pessoal ou empresas com faturamento < $1M/ano

2. Obter API Key

  1. Apos login, va para Account > API Keys (ou acesse direto: https://platform.stability.ai/account/keys)
  2. Clique em Create API Key
  3. De um nome (ex: "claude-skills")
  4. Copie a key gerada (comeca com sk-)

3. Configurar a Key

Edite o arquivo .env na raiz da skill (stable-diffusion/.env):

STABILITY_API_KEY=sk-sua-chave-aqui

Alternativa: exportar como variavel de ambiente:

export STABILITY_API_KEY="sk-sua-chave-aqui"

4. Instalar Dependencias

cd stable-diffusion
pip install -r scripts/requirements.txt

Unica dependencia externa: Pillow (manipulacao de imagens). As chamadas HTTP usam urllib (stdlib do Python).

5. Testar Conexao

python scripts/generate.py --list-models

Se a key estiver correta, voce vera a lista de modelos disponiveis.

6. Primeira Geracao

python scripts/generate.py --prompt "a beautiful sunset over mountains" --mode generate

A imagem sera salva em data/outputs/.

Troubleshooting

Erro 401 (Unauthorized)

  • Verifique se a key esta correta no .env
  • Verifique se nao ha espacos extras na key
  • Gere uma nova key no dashboard

Erro 402 (Payment Required)

  • Sua conta pode ter excedido limites de credito
  • Community License tem uso generoso mas pode ter restricoes em pico
  • Verifique o dashboard para status

Erro 429 (Rate Limited)

  • Limite: 150 requests a cada 10 segundos
  • O script ja faz retry automatico com backoff
  • Se persistir, aguarde alguns minutos

Erro 400 (Bad Request)

  • Verifique se o prompt nao esta vazio
  • Verifique se o aspect ratio e valido (use --list-models para ver opcoes)
  • Para img2img/inpaint, verifique se o arquivo de imagem existe

Imagem nao salva

  • Verifique permissoes de escrita em data/outputs/
  • O diretorio e criado automaticamente, mas pode falhar em ambientes restritos

Rate Limits Detalhados

Plano Requests/10s Modelos
Community 150 Todos SD3.5, Ultra, Core

Seguranca

  • A key nunca e logada ou exibida em outputs
  • O .env esta no .gitignore (nao committar!)
  • Limite diario configuravel: SAFETY_MAX_IMAGES_PER_DAY=100 (env var)
  • Contador diario em data/daily_counter.json