Intel 이미지 생성기
scripts/ 디렉토리는 이 파일을 기준으로 확인합니다. 사용자 작업 공간의 절대 경로로 출력 경로를 지정하세요.
먼저 선택한 항목 확인
모든 생성 전에, 생성에 사용할 모델/장치 옵션과 동일하게 --info를 실행하세요:
SKILL_DIR="/absolute/path/to/intel-image-generator"
env -u VIRTUAL_ENV uv run --project "$SKILL_DIR/scripts" --locked intel-image-generator --info
이 명령은 device와 model을 포함한 JSON을 출력합니다. 모델을 다운로드, 검증, 컴파일 또는 실행하지 않습니다. 선택된 장치와 모델을 사용자의 요청 및 아래 호환성 표와 대조하세요. --info가 성공했다고 해서 테스트되지 않은 모델이 작동한다고 말하지 마세요. 사용자가 재정의를 요청하지 않는 한 보고된 모델을 사용하세요. 다른 모델로 조용히 대체하지 마세요.
그런 다음 동일한 옵션, 프롬프트 및 출력으로 생성합니다. 자동 선택을 유지하려면 --device를 생략하거나, 사용자가 요청할 때 명시적 장치를 사용하세요:
env -u VIRTUAL_ENV uv run --project "$SKILL_DIR/scripts" --locked intel-image-generator \
--size 512x512 --seed 42 --steps 20 \
-p "친근한 코끼리, 플랫 일러스트레이션" \
-o /absolute/path/to/output.png
종료 상태를 확인하고 출력 파일이 존재하는지 확인한 후, 해당 경로를 반환하세요. 모델/장치 옵션을 변경하는 경우 먼저 --info를 다시 실행하세요.
옵션
--info(롱 옵션만 해당)는 프롬프트나 출력이 필요 없습니다. 생성에는 정확히 하나의 -p/--prompt TEXT 또는 -i/--input PATH(UTF-8, 비어있지 않은 각 줄이 하나의 프롬프트)와 -o/--output PATH가 필요합니다. 파일의 프롬프트는 순차적으로 생성되며, 프롬프트당 하나의 이미지가 생성됩니다. 여러 이미지는 stem-1.ext, stem-2.ext 등으로 저장됩니다. 각 파일은 원자적입니다. 모든 대상 경로는 사전 검증되며, 실패한 실행에서 이전에 완료된 이미지는 유지될 수 있습니다. -m/--model NAMESPACE/REPOSITORY는 호환되는 모델을 선택합니다. --model-dir PATH는 로컬 내보내기를 선택합니다(상호 배타적). 기타 옵션: --size WIDTHxHEIGHT, --seed INTEGER, --steps INTEGER, --device NPU|GPU|CPU.
참조 이미지 조건화를 위해 -r/--reference PATH를 --model stable-diffusion-v1-5/stable-diffusion-v1-5와 함께 사용하세요. 이는 img2img가 아닌 IP-Adapter를 사용한 텍스트-이미지 변환입니다. 캐릭터 동일성이나 정확한 스타일을 보장하지 않습니다. --source, --strength 또는 --model-dir과 함께 사용할 수 없습니다. 기본 모델이더라도, NPU에서 기본값이 다른 경우에도 필수 모델을 명시해야 합니다. 첫 사용 시 수 GB를 다운로드하고 별도의 내보내기를 생성합니다. 모델을 조용히 변경하지 마세요.
img2img의 경우 -s/--source PATH를 시작 이미지로 사용하고 선택적으로 --strength FLOAT(0 초과, 최대 1, 기본값 0.75)를 사용합니다. --strength는 --source가 필요합니다. --style은 제거되었습니다. -r은 이제 참조 조건화를 선택하고 -s는 img2img 소스를 선택합니다.
--device 없이 통합 Intel GPU 시스템은 NPU → GPU → CPU 순서로 선호합니다. 개별 Intel GPU 시스템은 GPU → NPU → CPU 순서로 선호합니다. 알 수 없는 GPU 유형 또는 GPU 속성 감지 실패 시 CPU로 폴백합니다. 명시적 선택은 엄격합니다. 컴파일/추론 오류 시 장치 재시도를 수행하지 않습니다.
NPU 모델 호환성
다음은 이 스킬의 단일 모델 호환성 목록입니다. 증거는 정확한 모델 및 소프트웨어 설정에 적용되며, 모든 파생 모델에 적용되지는 않습니다.
| Hugging Face 모델 | 이 CLI에 대한 NPU 상태 |
|---|---|
stable-diffusion-v1-5/stable-diffusion-v1-5 | CPU/GPU 기본값; NPU 테스트됨: 로컬로 내보내기; Lunar Lake Intel AI Boost에서 OpenVINO 2026.4.1 / Optimum Intel 1.27.0으로 성공적인 생성. |
OpenVINO/stable-diffusion-v1-5-fp16-ov | 호환 가능한 SD 파이프라인 후보; 여기서 NPU 테스트되지 않음. 성공적인 컴파일을 보장하지 마세요. |
OpenVINO/stable-diffusion-v1-5-int8-ov | NPU 기본값; Lunar Lake에서 OpenVINO 2026.4.1 / Optimum Intel 1.27.0으로 하나의 이미지 성공적으로 생성됨. |
Intel/sd-1.5-square-quantized | Intel의 카드 이름은 NPU이지만, 저장소에 필요한 Diffusers model_index.json/구성 요소 레이아웃이 없습니다. 이 CLI의 --model과 직접 사용할 수 없음. |
SDXL 및 FLUX는 다른 파이프라인 지원이 필요하며 이 CLI에서 NPU 대안으로 선택할 수 없습니다. 호환성을 테스트하기 위해 자동으로 후보를 다운로드하지 마세요.
모델 안전 검사기는 비활성화되어 있습니다. 설정, 첫 실행 비용, 모델/라이선스 세부 정보 및 문제 해결은 README.md를 참조하세요. 조용히 CPU로 폴백하거나 승인되지 않은 시스템/드라이버 변경을 수행하지 마세요.