Higgsfield AI 인플루언서 파이프라인 (CLI)

> 출처: 조코딩 「가상 인플루언서 유나 만들기」 14단계 verbatim 프롬프트 (jocoding.net/higgsfield)

> 용도: 결과물 유형별 재사용 템플릿. {{변수}}만 치환하면 우리 인플루언서/제품에 그대로 적용.

> 모델 매핑: gpt_image_2(얼굴·각도·캠페인), nano_banana_2(자연 셀카), seedance_2_0(영상)

---

0. 공통 자산

0-1. `<<<...>>>` 구문 = 캐릭터 주입

실제 전송 프롬프트에서 <<<element_id>>> 위치에 그 캐릭터(soul/element) 이미지가 자동 주입됨.
우리 CLI 대응: --custom_reference_id <soul_id> 또는 프롬프트에 soul_id 명시 + --image 레퍼런스.

0-2. ⭐ STYLE_ANCHOR (거의 모든 이미지에 반복되는 리얼리즘 앵커)

Shot on iPhone, natural daylight, bright exposure, clean white balance, soft realistic shadows, realistic skin texture with visible pores, true-to-life colors, no beauty filter, no excessive smoothing, no CGI, no AI artifacts, no studio lighting, vertical.

> 이게 "AI 티" 제거의 핵심. 광고처럼 안 보이고 실제 아이폰 셀카처럼 만드는 장치.

0-3. IDENTITY_LOCK (인물 일관성 잠금 — 영상·변신·광고 전부)

The woman must remain EXACTLY the same person throughout — preserve facial identity, face shape, facial proportions, eye shape, nose, lips, jawline, skin tone, hairstyle length, and body proportions. No identity drift. No face morphing.

0-4. 변수 사전

| 변수 | 의미 | 유나 예시 |

|---|---|---|

| {{ELEMENT}} | 캐릭터 soul/element ID | 270efdd3-... |

| {{NATION_AGE}} | 국적·나이대 | pretty Korean woman in her 20s |

| {{FACE}} | 얼굴형·표정·헤어 | round soft face, warm expression, long straight black hair |

| {{SCENE}} | 배경 | cafe by a big window / bedroom |

| {{PRODUCT_DESC}} | 제품 라벨 묘사(100% 보존용) | 아래 11번 참고 |

| {{PRODUCT_NAME}} | 제품명 | MEDITHERAPY Collagen Peptide 12X Boosting Serum |

| {{DIALOGUE}} | 한국어 대사 | 아래 12·13번 참고 |

---

1. 베이스 얼굴 생성 (text→image, 후보 N컷)

모델: gpt_image_2 · quality high · 2k · 3:4 · count 4

용도: 인플루언서 얼굴 후보 만들고 1컷 채택 → 캐릭터 등록용

A natural candid smartphone photo of {{NATION_AGE}}, shot on iPhone, clean front-facing angle, soft natural daylight, plain neutral background, realistic skin texture with visible pores, minimal no-makeup look, slight imperfect framing, no heavy grain, not retouched, no beauty filter, not studio. {{FACE}}, vertical orientation.

> 컷마다 {{FACE}}(얼굴형·표정·헤어색)와 배경색만 바꿔 4종 생성. 조코딩 4컷 변형:

> - 컷1: Round soft face, warm friendly expression, long straight black hair

> - 컷2: Slim oval face, gentle smile, shoulder-length wavy brown hair / pastel wall

> - 컷3: Defined jawline, calm neutral expression, dark hair low ponytail / near window

> - 컷4: Youthful soft features, bright cheerful expression, short bob with bangs, a few freckles / beige

---

2. 레퍼런스 풀세트 (캐릭터 보강용 다각도)

모델: gpt_image_2 · high · 2k · 3:4 · 각 count 1

용도: 채택 얼굴을 좌/우/후면으로 → 묶어서 강화 캐릭터 재등록

The exact same woman from the reference <<<{{ELEMENT}}>>> — identical face and hair, {{HAIR}}. {{ANGLE}}, clean neutral expression, plain soft-grey background, even soft light, realistic skin texture with visible pores, photoreal, shot on iPhone, no beauty filter, not retouched, vertical.

{{ANGLE}} 값:

좌측: Three-quarter left view, near side profile
우측: Three-quarter right view, near side profile facing right
후면: Back view from behind, head facing away showing the back of her head and hair

> ⭐ Element 사후 이미지 추가 불가 → 정면+좌+우 3컷을 묶어 새 캐릭터로 재등록(유나→유나-1). 일관성 크게 향상.

> 우리 CLI: higgsfield soul-id create --name 유나-1 --soul-2 --image <정면> --image <좌> --image <우> ...

---

3. 민낯 셀카 BEFORE (변신 영상 시작 프레임)

모델: gpt_image_2 · high · 2k · 3:4 · count 4

A casual front-camera selfie of <<<{{ELEMENT}}>>>, the same young Korean woman, at home in her bedroom, just-woke-up look, completely bare face with no makeup, slightly puffy tired eyes and faint under-eye, messy bun with flyaway hairs, oversized worn t-shirt, plain sleepy expression, flat soft daylight from the window, plain bedroom wall behind. Arm's length, shot on iPhone front camera, mild selfie lens distortion, slightly grainy, imperfect tilted framing, realistic skin texture with visible pores and slight skin shine, true-to-life colors, candid, no beauty filter, not retouched, not studio, vertical.

---

4. 메이크오버 AFTER (변신 영상 끝 프레임)

모델: gpt_image_2 · high · 2k · 3:4 · count 4

레퍼런스: BEFORE 셀카 1컷 + 캐릭터 ID

A real AFTER selfie of <<<{{ELEMENT}}>>>, the EXACT SAME young Korean woman from the reference image, taken about 30 minutes later after visiting a premium Korean hair salon and makeup shop. Preserve her facial identity, facial proportions, eye shape, nose, lips, jawline, skin tone, and body proportions — she must unmistakably be the same person. Same bedroom and background as the reference, same soft window daylight but her face brighter and more flattering, do not darken the room.

Professional Korean idol makeup, clearly more polished than everyday: flawless radiant glass skin with natural texture and visible pores, softly contoured face, brighter under-eye, naturally lifted eyebrows, defined brown gradient eye makeup, subtle shimmer on eyelids, thin eyeliner with slightly elongated outer corners, curled lashes with natural mascara, soft aegyo-sal, peach-pink blush high on the cheeks, glossy pink gradient lips, subtle nose highlight, healthy luminous complexion.

Hair completely down, professionally blow-dried Korean salon hair with beautiful volume, large soft S-curls and C-curls framing her face, silky glossy healthy thick smooth perfectly styled. No messy strands, no flat roots, no bedhead, not tied.

Stylish feminine Korean outfit suitable for a date or cafe, elegant knit top or blouse in ivory/beige/cream/light gray/pastel, fashionable but modest, modern Korean influencer aesthetic.

Much happier, bright genuine smile, confident. Different selfie pose and slightly different camera angle than the reference so it feels like a genuine second photo. Shot on iPhone, realistic selfie, true-to-life colors, natural skin texture, no beauty filter, no AI over-smoothing, no studio lighting, no HDR, looks like a real iPhone photo posted on Instagram, vertical.

---

5. 글로우업 변신 영상 (BEFORE→AFTER, 손 스와이프 전환)

모델: seedance_2_0 · 5s · 9:16 · 1080p · count 4

medias: --start-image BEFORE --end-image AFTER

A seamless viral Korean beauty glow-up transformation selfie video. The woman must remain EXACTLY the same person throughout — preserve facial identity, face shape, proportions, eye shape, nose, lips, jawline, skin tone, body proportions. Same room, same background, same camera position, realistic handheld iPhone front camera, vertical selfie, natural handheld movement, slight breathing motion, no cinematic moves, no zooms, no jump cuts.

0.0–1.4s: She looks exactly like the BEFORE start image — freshly woke up, natural bare face, relaxed sleepy expression, looking into the camera. 1.4–2.3s: she smiles slightly and confidently raises one hand toward the camera, her hand smoothly wipes across the lens until it fully covers the screen. 2.3–3.0s: while the lens is fully covered by her hand, a perfectly seamless instant transformation into the AFTER look, no visible morphing artifacts. 3.0–5.0s: reveal the completed AFTER look exactly matching the end image — professionally styled Korean salon hair with soft S-curls, elegant K-beauty makeup, glowing healthy skin, fashionable outfit, bright confident smile. She naturally brushes her hair behind one ear, tilts her head slightly, and smiles confidently into the camera.

Expression happy, confident, elegant, feminine. Lighting becomes slightly brighter and warmer after the transformation, skin naturally radiant but realistic. Natural blinking, subtle breathing, soft hair movement, no exaggerated animation. Looks like a real iPhone selfie video, true-to-life colors, realistic skin texture with visible pores, no beauty filters, no excessive smoothing, no CGI, no AI artifacts, no identity drift, no face morphing. The hand swipe completely hides the transition for an effortless satisfying reveal.

> ⭐ 핵심 트릭: 손으로 렌즈 가리는 순간 전환 → 모핑 아티팩트를 숨겨 자연스러운 변신.

---

6. 제품 캠페인 이미지 4컷 (광고 스틸)

모델: gpt_image_2 · high · 2k · 3:4 · 각 count 1

레퍼런스: 제품 병 이미지 + 캐릭터 ID

선행: 제품을 Marketing Studio Product Asset으로 등록 (marketing-studio products create)

PRODUCT_DESC 블록 (라벨 100% 보존 — 모든 컷에 삽입)

the EXACT product from the reference image: a clear glass dropper serum bottle with white dropper cap labeled 'Collagen Peptide 12X Boosting Serum, Nano Collagen, Vitamin A, C' and 'MEDITHERAPY' wordmark at the bottom — keep the bottle shape, dropper, transparency, label layout, logo, typography, printed text and proportions 100% identical and perfectly readable, naturally integrated, never oversized or floating or distorted

공통 템플릿

Premium Korean beauty campaign photo, {{SHOT_TYPE}}. The woman is <<<{{ELEMENT}}>>> — preserve her exact facial identity, proportions, eye shape, nose, lips, jawline, skin tone, hairstyle length. She {{PRODUCT_ACTION}} {{PRODUCT_DESC}}. {{EXPRESSION}}, luxury K-beauty makeup, radiant glass skin, healthy glow, glossy gradient lips, glossy Korean salon hair with soft S-curls, {{OUTFIT}}. {{LOCATION}}. Looks like a real iPhone photo, natural daylight, bright exposure, clean white balance, realistic skin texture with visible pores, no beauty filter, no CGI, no AI artifacts, vertical.

4컷 변형:

|---|---|---|---|

브랜드 방향 (참고 — 프롬프트에 녹여도 됨)

Premium Korean beauty. Luxury but believable. Olive Young / Tamburins / Hince / Dasique / Fwee / Amuse / Nonfiction aesthetic. Not Western luxury, not heavy glamour. Natural premium elegance.

---

7. UGC 말하는 영상 (광고 릴스)

모델: seedance_2_0 · 12s · 9:16 · 1080p · count 4 · generate_audio: true

medias: --start-image <캠페인스틸> --image <제품병>

Authentic Korean beauty UGC selfie video, real iPhone front camera, vertical handheld, very subtle natural handheld movement, starting smoothly from the reference image. The woman is <<<{{ELEMENT}}>>>, exactly the same person as the start image throughout — consistent facial identity, face shape, eye shape, nose, lips, jawline, skin tone, hairstyle, makeup and outfit, no identity drift, no face morphing. She holds the registered {{PRODUCT_NAME}} ({{PRODUCT_DESC_SHORT}}) — keep the bottle, cap, label, logo, typography, colors and proportions exactly as the reference, branding readable, the serum stays naturally in her hand without covering her face.

{{LOCATION}}. Beginning: she smiles naturally, raises the serum slightly toward the camera, looks into the lens. She speaks to camera with natural Korean lip sync, relaxed conversational pacing, smiling, friendly eye contact, subtle head movement, natural blinking, small natural hand gestures, natural breathing and pauses between sentences — spontaneous like a real Korean beauty creator, never scripted, never like a TV commercial.

Korean dialogue, spoken slowly and warmly: "{{DIALOGUE}}"

Ending: she gently raises the serum beside her cheek, turns the bottle so the label is visible, tilts her head slightly, smiles warmly, hold naturally. Shot on iPhone, natural daylight, bright exposure, soft natural shadows, realistic skin texture with visible pores, natural hair movement, no beauty filter, no excessive smoothing, no AI artifacts, no CGI, true-to-life colors. Looks like a genuine Instagram Reel filmed by a Korean beauty influencer.

대사 예시(유나):

A: 안녕하세요, 유나예요. 요즘 피부 좋다는 사람들 보면 이런 탄력 세럼 하나씩은 꼭 루틴에 넣더라고요. 이 제품은 열두 가지 펩타이드와 나노 콜라겐을 담은 부스팅 세럼이에요. 데일리 루틴으로 사용하기 좋아 보여요.
B(짧은 버전): 안녕하세요, 유나예요. 요즘 피부 관리할 때 이런 세럼 하나쯤은 많이 쓰더라고요. 가볍게 쓰기 좋아요.

> ⚠️ 대사 길이 = 영상 길이에 맞춰라. 12초 ≈ 짧은 3~4문장. 빠른 낭독 방지.

---

핵심 노하우 요약 (조코딩 + 우리 CLI 실측 2026-06-29)

1. 사용자입력 ≠ 전송 프롬프트: 입력은 자연어, 시스템이 <<<element>>> 주입+정제. 우리 CLI는 정제 버전을 직접 작성.

2. STYLE_ANCHOR 필수: "no beauty filter / visible pores / real iPhone" → 광고 티 제거.

3. IDENTITY_LOCK 반복: 영상·변신·광고마다 "same person, no morphing" 명시 안 하면 얼굴 바뀜.

4. 제품 라벨: "100% identical, perfectly readable" 강하게 안 박으면 글씨 깨짐.

5. 변신 영상 손 스와이프: 전환을 손으로 가려 모핑 숨기기.

6. 캐릭터 보강: 1컷 < 3컷(정면+좌+우) 재등록이 일관성 압도적으로 높음.

⭐ CLI 모델 선택 (우리 실측 — 조코딩 MCP와 다른 부분)

soul 이미지(인물 단독·민낯·메이크오버) = text2image_soul_v2 --custom_reference_id <soul> (0.12크레딧, 압도적 저렴 + 일관성 좋음).
제품 합성 광고(인물+제품) = gpt_image_2 --image <인물컷> --image <제품컷> (7크레딧). ⚠️ soul 모델에 제품 이미지 주면 제품을 재현(봉투 안에 얼굴 합성) 해버려 망함 → 반드시 gpt_image_2 멀티레퍼런스.
변신/말하기 영상 = seedance_2_0 --start-image --end-image (5s 45크레딧, 12s UGC는 audio 포함 더 비쌈).
--json 결과는 result_url만 추출 (medias 레퍼런스 URL 섞임). --wait에 | tail 금지(잘림).

⭐ 글램 강도 잡기 (soul 한계)

soul은 메이크업이 "과하거나 거의 없거나" 양극단으로 감. 데일리 글램 = 눈·립은 또렷하게(brown eyeshadow·winged liner·glossy lips) 명시 + 블러셔는 "very soft, NOT red, NOT heavy"로 억제. "full glam" 한 단어로는 무대 블러셔 폭발.

Marketing Studio API

marketing-studio products create 현재 Method Not Allowed(권한/엔드포인트 이슈). 우회: 제품 등록 없이 위 gpt_image_2 멀티레퍼런스로 직접 광고컷 생성(조코딩도 4컷은 이 방식).

쿠팡 제품 이미지 수집

firecrawl 금지(계정 로봇인증). 진짜 크롬 바이너리 직접 실행(webdriver=false) + coupang-partners-cdp/scrape_detail.py --cdp :9227. 단독 제품컷 없으면 상세페이지(긴 jpg)에서 패키지 부분 PIL 크롭.