Gerador de imagens Intel
Resolva scripts/ relativo a este arquivo. Use um caminho de saída absoluto no espaço de trabalho do usuário.
Verifique a seleção primeiro
Antes de cada geração, execute --info com as mesmas opções de modelo/dispositivo pretendidas para a geração:
SKILL_DIR="/caminho/absoluto/para/intel-image-generator"
env -u VIRTUAL_ENV uv run --project "$SKILL_DIR/scripts" --locked intel-image-generator --info
Isso imprime JSON contendo device e model. Não baixa, valida, compila ou executa o modelo. Verifique o dispositivo e modelo selecionados em relação à solicitação do usuário e à tabela de compatibilidade abaixo. Não afirme que um modelo não testado funciona porque --info é bem-sucedido. Use o modelo reportado, a menos que o usuário solicite uma substituição. Não substitua silenciosamente por um modelo diferente.
Em seguida, gere com as mesmas opções, prompt e saída. Omita --device para manter a seleção automática, ou use um dispositivo explícito quando o usuário solicitar:
env -u VIRTUAL_ENV uv run --project "$SKILL_DIR/scripts" --locked intel-image-generator \
--size 512x512 --seed 42 --steps 20 \
-p "Um elefante amigável, ilustração plana" \
-o /caminho/absoluto/para/saida.png
Verifique o status de saída e se a saída existe; então retorne seu caminho. Se alterar as opções de modelo/dispositivo, execute --info novamente primeiro.
Opções
--info (apenas longa) não precisa de prompt/saída. A geração requer exatamente um de -p/--prompt TEXTO ou -i/--input CAMINHO (UTF-8, um prompt por linha não vazia), além de -o/--output CAMINHO. Prompts de um arquivo são gerados sequencialmente, uma imagem por prompt, salvando múltiplas imagens como stem-1.ext, stem-2.ext, etc. Cada arquivo é atômico; todos os destinos são pré-validados e uma execução com falha pode reter imagens concluídas anteriormente. -m/--model NAMESPACE/REPOSITÓRIO seleciona um modelo compatível; --model-dir CAMINHO seleciona uma exportação local (mutuamente exclusivos). Outras opções: --size LARGURAxALTURA, --seed INTEIRO, --steps INTEIRO, --device NPU|GPU|CPU.
Para condicionamento por imagem de referência, use -r/--reference CAMINHO com --model stable-diffusion-v1-5/stable-diffusion-v1-5. Isso usa IP-Adapter para texto-para-imagem, não img2img; não garante identidade do personagem ou estilo exato. Não pode ser combinado com --source, --strength ou --model-dir. O modelo exigido deve ser explícito mesmo quando é o padrão, inclusive para NPU onde o padrão é diferente. O primeiro uso baixa vários GB e cria exportações separadas. Não altere silenciosamente o modelo.
Para img2img, use -s/--source CAMINHO para a imagem inicial e opcionalmente --strength FLOAT (maior que 0 e no máximo 1, padrão 0.75). --strength requer --source. --style foi removido; -r agora seleciona condicionamento por referência e -s seleciona uma fonte img2img.
Sem --device, sistemas Intel com GPU integrada preferem NPU → GPU → CPU; sistemas Intel com GPU discreta preferem GPU → NPU → CPU. Tipo de GPU desconhecido ou detecção de propriedade de GPU falha cai para CPU. Escolhas explícitas são rigorosas. Erros de compilação/inferência não acionam novas tentativas de dispositivo.
Compatibilidade de modelo NPU
Esta é a lista única de compatibilidade de modelos para este skill. A evidência se aplica ao modelo exato e configuração de software, não a cada derivado.
| Modelo Hugging Face | Status NPU para esta CLI |
|---|---|
stable-diffusion-v1-5/stable-diffusion-v1-5 | Padrão CPU/GPU; testado em NPU: exportado localmente; geração bem-sucedida em Lunar Lake Intel AI Boost com OpenVINO 2026.4.1 / Optimum Intel 1.27.0. |
OpenVINO/stable-diffusion-v1-5-fp16-ov | Candidato compatível de pipeline SD; não testado em NPU aqui. Não prometa compilação bem-sucedida. |
OpenVINO/stable-diffusion-v1-5-int8-ov | Padrão NPU; gerou com sucesso uma imagem em Lunar Lake com OpenVINO 2026.4.1 / Optimum Intel 1.27.0. |
Intel/sd-1.5-square-quantized | O cartão da Intel nomeia NPU, mas seu repositório carece do layout model_index.json/componente Diffusers exigido. Não utilizável diretamente com --model desta CLI. |
SDXL e FLUX exigem suporte de pipeline diferente e não são alternativas NPU selecionáveis nesta CLI. Não baixe candidatos automaticamente apenas para testar compatibilidade.
O verificador de segurança do modelo está desabilitado. Consulte README.md para configuração, custos de primeira execução, detalhes de modelo/licença e solução de problemas. Não caia silenciosamente para CPU ou faça alterações não aprovadas no sistema/driver.