MOSS-Image LoRA 사용법: Base·SFT 파일, ComfyUI 형식, Civitai 링크

이번 달 Hugging Face를 휩쓴 오픈 텍스트-투-이미지 모델 MOSS-Image에서 커뮤니티 LoRA를 쓰려면, 먼저 올바른 파일, 올바른 링크, 트리거 단어가 필요합니다. 이 가이드는 직접 실행해 본 오픈소스 MOSS-Image LoRA 8종을 사용해, 호스팅 API에서 이 세 가지를 차례로 보여 드립니다.

요약: MOSS-Image는 OpenMOSS가 공개한 50억 파라미터 규모의 오픈 디퓨전 트랜스포머이며, Apache-2.0 라이선스로 Base와 SFT 두 개의 체크포인트가 있습니다. MOSS-Image LoRA에서는 요청 한 번에 최대 3개의 LoRA를 추가할 수 있으며, 각 LoRA는 .safetensors 파일의 직접 링크로 지정합니다. 2026년 10월 21일과 22일에 8개 중 6개 파일을 직접 실행했고, 6개 모두 정상적으로 불러와졌습니다. 나머지 2개는 Civitai 파일이라 다운로드하려면 로그인이 필요하므로, 직접 호스팅해야 합니다. LoRA를 불러와도 추가 요금은 없습니다.

Comfy-Org가 배포한 MOSS-Image 리패키지는 2026년 10월 22일까지 Hugging Face에서 129만 회 이상 다운로드되었고, 첫 주에 MOSS-Image 태그가 붙은 LoRA 저장소가 43개 등장했습니다. 아래 표는 실제로 실행한 결과입니다.

이 가이드에서 사용하는 LoRA 파일 8종

다운로드 수와 좋아요 수는 2026년 10월 22일 기준입니다. "테스트됨"은 해당 파일을 엔드포인트에서 실제로 실행했다는 뜻입니다.

커뮤니티 목록의 다운로드 수와 파일별 테스트 상태는 추천 MOSS-Image NSFW LoRA에서 확인하세요. 표에서 자세히 볼 만한 결과가 두 가지 있습니다. Smartphone Snapshot 파일은 따뜻한 시네마틱 카페 장면을, 더 평평하고 차가운 톤의 폰 스냅샷 느낌으로 바꾸었고 화면도 더 넓어졌습니다. Finish Tweaker는 정상적으로 불러와졌지만 1.0에서는 변화가 작았습니다. 구도는 같고 빛과 질감만 약간 달라졌습니다.

코드에서 MOSS-Image LoRA를 실행하는 방법

Python SDK를 설치하고(pip install spicyapi), 환경 변수에 SPICY_API_KEY를 설정한 뒤 아래를 실행하세요. 파일이 바뀌어도 바뀌는 것은 프롬프트 텍스트뿐입니다.

import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment

task = client.create_task(
    model="openmoss/moss-image-lora/text-to-image",
    input_data={
        "prompt": "moss_beauty_style, close-up editorial portrait of an adult man in his thirties, white linen shirt, soft window light, plain background.",
        "loras": [{
            "path": "https://huggingface.co/axiomofmind/Moss-image-beauty-lora/resolve/main/pytorch_lora_weights.safetensors",
            "scale": 1,
        }],
        "aspect_ratio": "4:5",
        "resolution": "1k",
        "seed": 7,
    },
    idempotency_key=str(uuid.uuid4()),
)
final = client.wait_for_terminal(task["taskId"])
print(output_assets(final)[0]["url"])  # copy the image to your own storage

요청에 들어가는 항목은 다음과 같습니다.

• loras: 최대 3개 항목. 각 항목은 {"path", "scale"} 형식입니다. scale은 0에서 4까지이며 기본값은 1입니다.
• path: .safetensors 파일의 직접 링크입니다. Hugging Face라면 저장소 페이지가 아니라 /resolve/main/ 주소를 쓰세요.
• prompt: 최대 12,000자. 트리거 단어를 맨 앞에 두세요.
• aspect_ratio: 15가지 옵션이 있습니다.
• resolution: 1k, 1.5k, 2k.
• output_format: jpeg, png, webp.
• seed: 결과를 반복해서 비교할 때 쓰세요.

트리거 단어를 앞에 두고, LoRA는 최대 3개까지 쌓고, 더 높이기 전에 scale을 0.6에서 1 사이로 맞춰 보세요. SDK와 작업 처리 방식은 작업 가이드에 정리되어 있습니다.

이 엔드포인트에는 step이나 guidance 조절 기능이 없습니다. 속도 측면에서 중요한 점입니다. Civitai와 Hugging Face에서 인기 있는 Turbo나 4단계 distill 어댑터는 여기서 속도를 높이지 못하므로, 목록에서 뺐습니다. LoRA를 포함한 요청은 1k 기준 중앙값 약 18초가 걸렸습니다. 새 LoRA 파일을 처음 쓰는 요청은 파일을 불러오는 동안 더 느립니다.

LoRA가 실제로 그림을 바꾸는가

불러오는 것과 효과가 있는 것은 다릅니다. LoRA를 불러오지 않은 상태에서 LoRA 엔드포인트는 같은 프롬프트와 seed로 일반 MOSS-Image와 같은 그림을 돌려주었습니다. 그래서 가장 확실한 검증은 대조군입니다. 같은 프롬프트와 seed로 파일을 쓸 때와 쓰지 않을 때를 비교하세요.

위 프레임에서 Smartphone Snapshot 파일은 그림을 더 평평하고 차가운 느낌으로 바꾸었고, Finish Tweaker는 대조군에 가깝게 머물렀습니다. 같은 seed로 비교하는 방법은 단계별로 같은 seed 테스트 가이드에서 설명했습니다.

스타일 LoRA: 회화와 포스터

두 스타일 파일 모두 프롬프트 앞에 트리거 단어를 두었을 때 이미지 전체의 느낌을 바꾸었습니다.

Gouache 파일은 평범한 장면을 구아슈 그림으로 다시 그렸습니다. 표에는 0.6으로 실행한 결과도 함께 있습니다. Psychedelic Poster는 글자의 철자를 정확하게 유지했습니다.

리얼리즘: 2k 티어의 인물 사진

이 프레임은 MOSS-Image Beauty 파일을 1.0으로, 2k 티어 9:16에서 사용했습니다. 위 코드처럼 프롬프트 앞에 트리거 moss_beauty_style을 두세요.

제약이 되는 것들

• Civitai 로그인 필요 파일. Realistic Snapshot과 DaSkin 파일은 10월 22일 직접 링크했을 때 HTTP 401을 반환했습니다. 본인의 Civitai 계정으로 파일을 내려받아, 직접 관리하는 HTTPS 직접 링크(예: 본인의 Hugging Face 저장소)에 올린 뒤 그 주소를 연결하세요.
• Base와 SFT. 10월 21일과 22일 테스트에서는 Base 체크포인트로 학습한 LoRA와 SFT 체크포인트로 학습한 LoRA를 모두 불러올 수 있었습니다. 둘 다 정상 로드되었지만, 효과는 각각 대조군과 비교해 판단하세요.
• 웹 페이지 링크는 실패합니다. 파일 링크 대신 Hugging Face 페이지 링크를 넣으면 "Failed to load LoRA: You should provide the direct download link…" 오류로 실패했습니다. 이 경우 요금은 청구되지 않았습니다.
• SpicyAPI 자체 콘텐츠 필터는 없습니다. 기본 모델은 10월 21일 테스트에서 다섯 가지 콘텐츠 수준(Mild, Moderate, Strong, Very strong, Maximum)을 모두 요청한 그대로 반환했습니다. NSFW Uncensored LoRA를 0.7로, 트리거를 앞에 두고 사용했을 때도 Strong 이상 프로브는 요청한 그대로 반환되었습니다.

가격

작성 시점(2026년 10월 22일) 기준 가격은 이미지 한 장당 요금입니다.

LoRA를 불러와도 추가 요금은 없습니다. LoRA가 0개에서 3개일 때 가격이 같습니다. LoRA 슬롯이 없는 기본 MOSS-Image는 1k 기준 $0.024입니다. 작업에 LoRA가 필요 없다면 기본 모델을 호출하세요. 현재 가격은 항상 모델 페이지에 표시됩니다.

작업별로 불러올 파일

• NSFW 작업: MOSS-Image NSFW Uncensored를 0.7로, 트리거를 앞에 두고 사용.
• 캐주얼한 사진의 폰 스냅샷 느낌: Smartphone Snapshot Photo Reality를 1.0으로. 다만 테스트에서 화면이 넓어졌으니 구도를 확인하세요.
• 인물 사진: MOSS-Image Beauty를 1.0으로, moss_beauty_style을 앞에 두고 사용. 작성자는 0.7~0.9도 괜찮다고 봅니다.
• 회화풍 스타일: MOSS-Image Gouache를 1.0으로. 표에 있는 두 번째 실행으로 0.6도 가능합니다.
• 포스터 글자: MOSS-Image Psychedelic Poster를 1.0으로.
• 마음에 드는 그림의 마무리와 디테일: Moss Image Finish Tweaker를 1.0으로. 변화는 작을 것입니다.
• 피부나 Realistic Snapshot 느낌: 먼저 파일을 직접 호스팅하세요. 두 가지 모두 엔드포인트에서 테스트하지 않았습니다.

기본 모델은 MOSS-Image 모델 페이지에서 확인할 수 있습니다. 다른 모델용 LoRA는 LoRA 허브에서 찾아보세요. 자신의 LoRA를 실행하는 일반적인 방법은 호스팅 API에서 나만의 LoRA 실행하기에 정리되어 있습니다.

FAQ

MOSS-Image LoRA란 무엇인가요?

MOSS-Image의 텍스트-투-이미지 기능에 직접 만든 LoRA 파일을 불러올 수 있는 슬롯을 더한 것입니다. 보통 MOSS-Image Base 또는 SFT로 학습된 커뮤니티 LoRA를 사용합니다. SpicyAPI에서는 loras 필드에 .safetensors 직접 링크를 넣으며, 요청 한 번에 최대 3개, 각각 scale은 0에서 4 사이로 지정합니다.

MOSS-Image Base용 LoRA가 SFT에서도 작동하나요?

2026년 10월 21일과 22일 테스트에서 두 종류 모두 불러와졌습니다. Base 체크포인트로 학습한 LoRA와 SFT 체크포인트로 학습한 LoRA 모두입니다. 불러오는 것과 효과가 있는 것은 다르므로, 파일마다 LoRA 없는 대조군과 비교하세요.

ComfyUI용 LoRA 파일을 쓸 수 있나요?

네. diffusers 파일 형식(pytorch_lora_weights.safetensors)과 ComfyUI 형식 모두 테스트에서 불러와졌고, 한 요청에 LoRA 3개를 겹쳐 써도 동작했습니다.

검열 없는 MOSS-Image LoRA가 있나요?

axiomofmind의 MOSS-Image NSFW Uncensored 파일이 목록에 있으며, 트리거 moss_xvstyle을 붙여 0.7로 실행했습니다. SpicyAPI는 자체 콘텐츠 필터를 추가하지 않습니다. 기본 모델은 우리가 테스트한 다섯 가지 콘텐츠 수준을 모두 요청한 그대로 반환했습니다.

Civitai 링크가 왜 실패하나요?

다운로드에 로그인이 필요한 Civitai 파일은 2026년 10월 22일 직접 링크했을 때 HTTP 401을 반환했습니다. 본인의 Civitai 계정으로 파일을 내려받아, 직접 관리하는 HTTPS 직접 링크에 올린 뒤 그 링크를 사용하세요.

성인용입니다. 모든 프롬프트와 업로드에는 성인만 등장시키고, 실제 인물의 얼굴을 본인 동의 없이 생성하지 마세요. 생성 결과에 대한 책임은 사용자에게 있습니다.

MOSS-Image LoRA 사용해 보기 →