Configuração do Stable Diffusion WebUI
O Stable Diffusion WebUI é comumente usado para geração local de imagens. Ele é diferente das ferramentas de chat: você configura principalmente os arquivos de modelo, sampler, dimensões, passos e prompts. Se quiser que outras ferramentas façam chamadas para ele, você precisa ativar a API primeiro.
Informações oficiais Downloads e documentação estão sujeitos ao site oficial.
Ativar a API
| Item de configuração | Método de preenchimento |
|---|---|
| Parâmetros de inicialização | --api |
| Endereço web | http://127.0.0.1:7860 |
| Documentação da API | http://127.0.0.1:7860/docs |
| API Text-to-image | /sdapi/v1/txt2img |
Referência da interface da WebUI Esta imagem é usada para confirmar o layout da interface principal. A disponibilidade da API depende se --api foi adicionado durante a inicialização e se /docs pode ser aberto.
- Instale e inicie o Stable Diffusion WebUI.
- Se quiser que scripts façam chamadas a ele, adicione o seguinte na inicialização
--api. - Abra
http://127.0.0.1:7860/docse confirme que a documentação da API pode ser aberta. - Primeiro gere uma imagem com sucesso na interface web e, em seguida, teste com a API.
- Se ocorrerem erros, verifique primeiro os arquivos de modelo, a memória de vídeo, o nome do sampler e o tamanho da imagem.
Entendendo os parâmetros de geração de imagem
| Configuração | Significado | Dicas para iniciantes |
|---|---|---|
| prompt | Prompts positivos | Escreva o que você deseja que apareça na imagem |
| negative_prompt | Prompts negativos | Escreva o que você não deseja que apareça |
| steps | Passos de amostragem | Comece com 20 a 30 passos, não defina um valor muito alto inicialmente |
| width / height | Tamanho da imagem | Comece no nível de 512 ou 768 e reduza caso a VRAM seja insuficiente |
| sampler_name | Sampler | Comece com o padrão ou com o sampler que funciona na interface web |
Exemplo de API
Requisição mínima para text-to-image no SD WebUI
curl -X POST http://127.0.0.1:7860/sdapi/v1/txt2img \ -H "Content-Type: application/json" \ -d '{ "prompt": "a clean product photo of a white ceramic cup", "negative_prompt": "blurry, low quality", "steps": 20, "width": 512, "height": 512 }'Dúvidas comuns de iniciantes
| Problema | Verificação prioritária | Solução |
|---|---|---|
/docs Não abre | Se foi adicionado na inicialização --api | Reinicie o WebUI e verifique se não há erros no console |
| Gera imagens na interface web, mas não pela API | Se o endereço da API é /sdapi/v1/txt2img | Teste primeiro com a requisição mínima, não adicione parâmetros demais de uma vez |
| Erro de sampler | Se o sampler_name existe | Tente deixar sampler_name em branco ou use o sampler que atualmente funciona na interface web |
| Memória de vídeo insuficiente | Largura, altura, steps, tamanho do lote (batch) | Comece com 512x512, 20 steps e aumente gradualmente |