Higgsfield 이미지 생성 (higgsfield-image)

개요

Higgsfield MCP의 이미지 생성 도구를 호출하는 스킬입니다. 사용자 자연어 요청에서 주제·용도·청중을 추출하고, 공식 11개 이미지 모델 중 가장 적합한 것을 선택해 자동으로 생성합니다.

트리거 키워드

Higgsfield 이미지, Soul, Soul 2.0, Soul Cinema, Nano Banana, Nano Banana Pro, GPT Image, GPT Image 2, Seedream 4.0, Flux Kontext, Wan 2.2 Image, Wan 2.5, AI 이미지 생성, 시네마틱 이미지, 캐릭터 일관성, 4K 이미지

전제 — MCP 등록

moai-media 플러그인 설치 시 .mcp.json이 Higgsfield MCP를 자동 등록합니다.

{
  "higgsfield": {
    "type": "http",
    "url": "https://mcp.higgsfield.ai/mcp"
  }
}

첫 호출 직전 Cowork에서 OAuth 인증을 1회 완료해야 합니다 (moai-media/CONNECTORS.md 참고).

공식 11개 이미지 모델 — 한눈에

higgsfield.ai 공식 페이지 기준 (2026-05).

Soul 계열 (Higgsfield 자체) ★

Soul Characters 기능으로 캐릭터 reference 학습 → 시리즈 일관성.

Nano Banana 계열 (Gemini 3 기반)

GPT Image 계열 (OpenAI)

Seedream

Flux 계열

Wan 계열 (중국 최신)

상세 모델별 사용 패턴은 references/model-guide.md.

워크플로우

1단계 — 의도 파악

사용자 한 줄 요청에서 다음을 추출:

• 주제 (예: "회의실에서 노트북 보는 30대 한국인 여성")
• 용도 (마케팅 키 비주얼 · SNS 카드 · 제품 샷 · 캐릭터 시리즈 · 발표 슬라이드)
• 청중 (B2B 임원 · 일반 대중 · 디자이너 · 개발자)
• 톤 (시네마틱 · 미니멀 · 다크 · 따뜻함 · 신뢰감)

부족하면 AskUserQuestion 1라운드.

2단계 — 모델 자동 선택

키워드 매칭. 매칭이 모호하면 후보 2-3개 제시.

3단계 — 파라미터 설계

4단계 — 비율 자동 매핑

5단계 — MCP 호출

ToolSearch(query: "select:mcp__higgsfield__generate_image")

mcp__higgsfield__generate_image({
  prompt: "[모델별 톤 보정된 프롬프트]",
  model: "soul_2_0",  // 또는 "nano_banana_pro" 등
  width_and_height: "1696x960",
  quality: "1080p",
  enhance_prompt: true,
  batch_size: 1
})

모델 식별자는 공식 페이지에서 underscore_separated 형식 사용 (예: soul_2_0, nano_banana_pro, seedream_4_0, flux_kontext).

6단계 — 비동기 잡 폴링

Higgsfield는 비동기 처리. 호출 직후 job ID를 받고 상태 폴링:

7단계 — 검수·변형

캐릭터 일관성 — Soul Characters

공식 Higgsfield 기능. Soul 또는 Soul 2.0과 결합:

1. 첫 호출 (Soul 2.0): 원하는 인물 1장 생성
2. Soul Characters에 reference 등록 → UUID 수령
3. 이후 호출: custom_reference_id 파라미터에 UUID 전달
4. 동일 인물 + 다른 포즈·배경·표정 생성

마케팅 캠페인·브랜드 캐릭터·시리즈 카드뉴스에 핵심.

사용 예시

예시 1 — 카드뉴스용 이미지 4종 (글자 정확)

요청: "스타트업 투자 카드뉴스 4장 이미지 만들어 줘 (글자 들어감)"

자동 선택: GPT Image 2 (글자 렌더링 SOTA) — 1순위
대안: Nano Banana Pro (2K, 보조)
비율: 1024x1024 (인스타 피드)
quality: 2K
batch_size: 4

예시 2 — 시네마틱 브랜드 키 비주얼

요청: "한국인 30대 여성 CEO가 회의실에서 노트북 보는 시네마틱 샷"

자동 선택: Soul 2.0 (인물 디테일) 또는 Soul Cinema (영화 룩)
비율: 1696x960 (16:9)
quality: 1080p

예시 3 — 캐릭터 시리즈

1차: Soul 2.0 → 인물 1장 → Soul Characters에 reference 저장
2차+: 같은 reference UUID로 동일 인물 다양한 포즈

예시 4 — 제품 사진 (사실적)

요청: "프리미엄 가죽 지갑 제품 샷, 흰 배경"

자동 선택: Flux Kontext (사진 사실성)
비율: 1024x1024
quality: 1080p

예시 5 — 광고 키 비주얼 (영화 톤)

요청: "신제품 광고 키 비주얼, 35mm 필름 룩"

자동 선택: Soul Cinema
비율: 1696x960
quality: 1080p

출력 형식

## Higgsfield 이미지 생성 결과

### 호출 정보
- 모델: [선택 모델, 예: soul_2_0]
- 프롬프트: [최종 프롬프트]
- 비율·해상도: [width_and_height · quality]
- Job ID: [Higgsfield job ID]

### 결과
- 이미지 URL: [Higgsfield CDN URL]
- 미리보기: ![](URL)
- 다운로드 경로: [로컬]

### 검수
- 텍스트 정확성·비율·해상도: [PASS]
- 의도 부합: [점수]

### 후속 추천
- 같은 seed로 부분 수정
- 다른 비율 변형
- Soul Characters reference 저장 (시리즈 작업 시)

비용 관리

• 모델별 크레딧 차등 (Soul Cinema·Pro급은 더 비쌈)
• batch_size=4는 크레딧 4배
• quality=2K·4K가 1080p보다 비쌈
• 워크스페이스 잔액: higgsfield.ai → Billing

주의사항

Do

• 영문·한국어 프롬프트 모두 OK
• 첫 호출은 batch_size=4로 탐색 후 확정
• 캐릭터 시리즈는 Soul Characters reference로 일관성
• 인쇄·고품질은 quality=2K 이상

Don't

• 200단어 초과 긴 프롬프트
• 모순된 요소 동시 요청 ("미니멀 + 화려한")
• nsfw·민감 콘텐츠
• 초상권 침해 가능한 인물 묘사
• 저작권 있는 캐릭터·로고 직접 묘사

트러블슈팅

관련 스킬

References

• references/model-guide.md — 11 모델별 강점·약점·예시 프롬프트
• Higgsfield 공식 사이트 — 모델 목록 (이미지 11종 + 영상 11종 + 30+ 광고)
• Higgsfield MCP 안내
• Higgsfield Skills

모델 목록 출처

본 스킬의 11개 이미지 모델 목록은 higgsfield.ai 공식 메인 페이지 명시 기준입니다 (2026-05). 모델은 Higgsfield 정책에 따라 추가·변경될 수 있습니다.