블로그

사용 가이드

개발자를 위한 Wan 2.7 비디오 텍스트-투-비디오 프롬프트 레시피

바로 복사할 수 있는 프롬프트 구조, 샷 세그먼트, 카메라 무빙, 페이싱, 네거티브 프롬프트를 포함

Nov 12, 2026
커버 아트: 겹겹이 포개진 반투명 유리 평면들이 옅은 색면을 차가운 푸른 띠로 굴절시키는 모습, 평면적이고 건축적인 느낌, 텍스트 없음.
이 페이지에서

프롬프트는 길이보다 구조가 더 중요한 이유

대부분의 실망스러운 텍스트-투-비디오 렌더링 결과는 프롬프트가 너무 짧아서가 아니라 구조가 없기 때문입니다. 피사체, 동작, 카메라, 조명, 페이싱을 모두 매끄러운 한 문단에 밀어 넣으면 모델은 어느 문장이 주요 지시이고 어느 문장이 수식인지 추측할 수밖에 없습니다. 그 결과는 그럴듯해 보이지만 예측 불가능한 클립입니다. 데모용으로는 괜찮지만 배치 생산에는 쓸 수 없습니다.

구조화된 프롬프트는 전혀 다릅니다. 클립을 명시적이고 라벨이 붙은 여러 관심사로 분해하여 각 부분이 독립적으로 해석되게 합니다. 이는 개발자에게 세 가지 실질적 이점을 줍니다:

  • 예측 가능성. 카메라 지시가 한 줄을 차지하면, 그것을 바꿀 때 카메라만 바뀝니다—피사체의 의상, 조명, 페이싱은 바뀌지 않습니다.
  • 비교 가능성. 두 구조화된 프롬프트는 줄 단위로 비교할 수 있지만, 두 개의 빽빽한 문단은 보통 그렇게 할 수 없습니다.
  • 재사용성. 이름 붙은 슬롯이 있는 뼈대는 프로그램으로 채울 수 있지만, 한 번 쓴 문단은 복사-붙여넣기만 가능합니다.

길이는 목표가 아닙니다. 잘 구조화된 프롬프트는 그것이 대체하는 문단보다 종종 더 짧습니다. 모든 문장이 제값을 하기 때문입니다. 산문이 아니라 작은 설정 파일로 취급하세요: 몇 개의 필드, 각 필드에 명확한 규약.

실용 규칙

한 줄을 가리키면서 그것이 무엇을 제어하는지 말할 수 없다면, 삭제하거나 슬롯으로 옮기세요. 슬롯에 매핑되지 않는 형용사("놀랍다", "압도적이다", "걸작")는 방향보다 잡음만 더하는 경우가 많습니다. 실제로 효과가 있는 것은 올바른 슬롯에 들어간 구체적인 명사와 동사입니다. 이 가이드의 나머지 부분은 모두 이 원칙을 중심으로 전개됩니다.

같은 내용, 다른 구조: 하나의 조밀한 덩어리와 다섯 개의 분리된 슬롯이 더 안정적인 출력 범위를 만든다.

다섯 슬롯 프롬프트 골격

모든 클립은 같은 골격에서 시작합니다. 다섯 슬롯이 대부분의 제어 가능한 변화를 포괄하며, 순서의 중요성은 일관성보다 낮습니다.

SUBJECT:   <누구 또는 무엇, 한 문장, 구체적 명사>
ACTION:    <클립에서 무슨 일이 일어나는지, 현재 시제로>
CAMERA:    <샷 크기 + 움직임 + 피사체 구도>
LIGHTING:  <시간대, 광원, 대비, 색온도>
PACING:    <지속 시간 느낌, 움직임 속도, 끝날 때의 변화>

각 슬롯에 무엇을 넣을까

SUBJECT(피사체)는 정체성을 고정합니다. 핵심만 남기세요: 엔티티 유형, 두드러진 특징, 의상 또는 재질. 여기서 이야기를 하지 마세요—그것은 ACTION의 역할입니다.

ACTION(동작)은 하나의 연속적인 동작 박자를 묘사합니다. "그녀가 창가에서 돌아서 컵을 든다"는 한 박자입니다. "그녀가 돌아서고, 컵을 들고, 문으로 걸어가 나간다"는 네 박자가 하나의 짧은 클립을 두고 다투는 것입니다.

CAMERA(카메라)는 샷 크기와 움직임을 함께 둡니다. 모델이 이들을 하나의 결정으로 읽기 때문입니다. "중간 샷, 천천히 푸시 인"은 자기 일관적입니다. 같은 프롬프트에 "클로즈업"과 "광각 설정 샷"이 동시에 나오면 그렇지 않습니다.

LIGHTING(조명)은 렌더링에 물리적 닻을 줍니다: 창문 빛, 흐린 날, 정오의 강한 햇빛, 따뜻한 실내 조명. 분위기를 조용히 제어하지만 감정이 아니라 사실로 진술하세요.

PACING(페이싱)은 클립이 끝날 때 시작과 비교해 어떤 모습이어야 하는지 모델에 알려줍니다. "느리고 연속적이며, 마지막 초에는 거의 정지"는 페이싱 지시입니다. "역동적" 하나만으로는 아닙니다.

채우기 예시

채운 골격은 다음과 같습니다:

SUBJECT:   a ceramic mug on a wooden desk, steam rising
ACTION:    steam curls upward and thins out
CAMERA:    close-up, locked-off, slightly low angle
LIGHTING:  soft morning window light from the left, cool shadows
PACING:    slow and continuous, nearly still by the final second

각 슬롯은 한두 줄로 유지하세요. 어떤 슬롯에 한 문단이 필요하다면, 그 클립은 아마 너무 많은 일을 하려는 것이므로 두 클립으로 나눠야 합니다.

다섯 개의 겹친 유리 평면은 다섯 개의 프롬프트 슬롯에 대응한다—어떤 클립에도 재사용할 수 있는 골격.

카메라 무빙과 페이싱 힌트 작성

카메라 언어는 프롬프트 품질이 가장 빠르게 갈리는 지점입니다. 모호한 움직임 동사는 모호한 움직임을 낳습니다. 실제 영화 촬영 용어를 빌리면 구체적인 기하학적 변화를 묘사하기 때문에 더 신뢰할 수 있습니다.

검증된 움직임 어휘

  • Pan(팬) — 카메라가 고정된 위치에서 수평으로 회전합니다. 방향과 함께 사용하세요: "천천히 왼쪽으로 팬".
  • Tilt(틸트) — 고정된 위치에서 위아래로 회전합니다.
  • Dolly / push in / pull out(돌리 / 푸시 인 / 풀 아웃) — 카메라가 물리적으로 피사체에 가까워지거나 멀어집니다.
  • Tracking(트래킹) — 카메라가 움직이는 피사체를 따라 함께 이동합니다.
  • Zoom(줌) — 초점 거리가 변하고 카메라 위치는 그대로입니다. 돌리와 다릅니다; 하나를 고르고 둘을 동시에 쓰지 마세요.
  • Orbit / arc(오빗 / 아크) — 카메라가 피사체 주위를 돕니다.
  • Locked-off(고정 카메라) — 전혀 움직이지 않습니다. 과소평가되지만 매우 신뢰할 수 있습니다.

항상 축을 속도, 피사체 관계와 결합하세요: "천천히 푸시 인, 피사체 중앙"이라고 쓰고 "드라마틱한 샷"이라고만 쓰지 마세요. 클립당 하나의 움직임이 안전한 기본값입니다. 두 움직임은 같은 축을 공유할 때 성립할 수 있습니다(천천히 푸시 인하면서 살짝 위로 틸트); 반대 방향의 움직임은 보통 서로 충돌합니다.

페이싱 힌트

페이싱은 클립의 문자적 길이가 아니라 시간에 따른 형태에 관한 것입니다. 유용한 문구:

  • "느리고 연속적인 움직임"
  • "움직임이 끝에서 정지로 수렴"
  • "일정 속도, 가속 없음"
  • "미세한 드리프트만 있음"

강도 형용사를 쌓지 마세요. "빠르고, 역동적이고, 활기차고, 영화 같은"은 모델에 따를 수 있는 형태를 전혀 주지 않습니다. "꾸준히 걸어 들어와 화면 중앙에 멈춘다"는 형태를 줍니다.

카메라와 페이싱의 조합

카메라와 페이싱은 서로 일치해야 합니다. 고정 카메라의 클로즈업에 "화면 속 빠른 움직임"은 모순입니다. 천천히 푸시 인에 "피사체는 거의 정지, 미세한 호흡 동작"은 자기 일관적입니다. 확신이 없을 때는 움직임의 진폭을 줄이고 구체성을 높이세요—정밀하게 묘사된 정지 샷이 모호하게 묘사된 역동적 샷보다 낫습니다.

움직임 어휘는 겹친 유리 평면과 같다: 팬, 틸트, 돌리, 줌은 모델이 일관되게 해석할 수 있는 방향성 제스처로 규정된다.

네거티브 프롬프트 목록 구축

네거티브 프롬프트는 배치에서 절대 보고 싶지 않은 것들을 나열한 작고 안정적인 목록입니다. 매 프롬프트마다 즉흥적으로 만들 것이 아니라 공유 인프라로 취급하세요.

간결한 핵심 목록

핵심 목록은 간결하게 유지하고 결함에 집중하세요:

blurry, low resolution, jpeg artifacts, watermark, text overlay,
distorted hands, extra fingers, warped faces, duplicate limbs,
flickering, frame tearing, abrupt cuts, oversaturated, blown highlights

약 십여 개 항목으로 첫 시도의 대부분 실패 사례를 포괄합니다. 렌더가 나쁠 때마다 충동적으로 항목을 추가하지 마세요—너무 긴 네거티브 목록은 결함과 함께 정당한 디테일까지 억제합니다.

프로젝트별 계층 추가

확장은 선택적이며 프로젝트 범위로 한정되어야 하고, 핵심 목록에 넣지 마세요:

core_negatives + ["logo visible", "brand colors"]        # product shots
core_negatives + ["crowd", "background people"]           # isolated subjects
core_negatives + ["rain", "wet surfaces"]                # interior scenes

이렇게 하면 공유 기준선이 안정적으로 유지되면서 각 프로젝트가 자체 제약을 강화할 수 있습니다. 목록을 건강하게 유지하는 두 가지 규칙: 같은 결함이 두 번 나타난 후에만 단어를 추가하세요; 원래 고쳤던 문제를 더 이상 재현할 수 없을 때 그 단어를 삭제하세요.

넣지 말아야 할 것

정말 원하는 스타일 단어를 부정하지 마세요(영화 같은 샷을 요구하면서 "영화 같지 않게"라고 쓰기), 움직임이 필요한 클립에서 움직임을 부정하지 마세요. 네거티브 프롬프트는 결함을 피하는 데 쓰이며, 특정 룩을 가리키는 데는 효과가 떨어집니다. 후자는 포지티브 슬롯으로 구현해야 합니다.

레시피를 API 요청 패턴으로 변환

레시피가 한 번 작동하면 더 이상 수동으로 붙여넣지 마세요. 이름 붙은 슬롯이 있는 템플릿으로 저장하고 매개변수에서 슬롯을 채우세요. 템플릿이 반복, 리뷰, 재사용의 단위가 됩니다.

템플릿 객체

{
  "template_id": "desk-product-closeup",
  "version": "3",
  "slots": {
    "subject": "a ceramic mug on a wooden desk, steam rising",
    "action": "{{action}}",
    "camera": "close-up, locked-off, slightly low angle",
    "lighting": "{{lighting}}",
    "pacing": "slow and continuous, nearly still by the final second"
  },
  "negative": "core_negatives"
}

그러면 요청 빌드 코드가 슬롯을 최종 프롬프트 문자열로 렌더링하고 HiAPI.ai의 텍스트-투-비디오 엔드포인트로 전송합니다. 모델 이름과 엔드포인트는 한곳에 고정되고 슬롯 값만 바뀝니다.

렌더링된 프롬프트 조립

PROMPT = """SUBJECT: {subject}
ACTION: {action}
CAMERA: {camera}
LIGHTING: {lighting}
PACING: {pacing}"""

def build_prompt(slots: dict) -> str:
    return PROMPT.format(**slots).strip()

두 가지 실용적 규약이 즉시 보상을 줍니다. 첫째, 슬롯 값을 짧게 유지하세요—두 줄을 넘는 슬롯은 보통 실제로 두 개의 슬롯입니다. 둘째, 골격 문자열을 고정하고 값만 바꾸세요; 실행 사이에 골격을 바꾸면 결과를 더 이상 비교할 수 없습니다. 슬롯에 구조적 변경이 필요하다면, 제자리 편집이 아니라 새로운 템플릿 버전입니다.

프롬프트 버전 관리와 출력 비교

프롬프트를 바꾸는 비용은 작지만, 맹목적으로 바꾸는 비용은 큽니다. 코드처럼 관리하세요: 각 렌더가 어떤 프롬프트에서 나왔는지 기록하고, 모든 프롬프트 변경에 검토 가능한 전후 비교를 남기세요.

렌더마다 기록할 것

  • 템플릿 id와 버전
  • 정확한 렌더링된 프롬프트 문자열, 슬롯 값만이 아니라
  • 네거티브 목록 버전
  • 출력 파일 또는 작업 id
  • 무엇을 바꾸려 했는지에 대한 한 줄 설명

이 기록이 있으면 나쁜 배치 결과 후에 정말 중요한 질문에 답할 수 있습니다: 이 변경이 회귀를 일으켰는가, 아니면 문제가 원래 존재했는가?

렌더 결과 비교

고립된 시각이 아니라 쌍으로 리뷰하세요. 대표적인 고정 슬롯 값 세트를 스모크 세트로 선택하세요—정지 샷, 움직임 샷, 클로즈업, 광각—템플릿 버전이 올라갈 때마다 다시 렌더링하세요. 같은 입력으로 새 결과와 옛 결과를 나란히 비교하세요. 스모크 세트에서 아무것도 변하지 않았다면 그 변경은 대체로 안전합니다. 한 사례를 개선하면서 다른 사례를 망쳤다면 경계를 찾은 것이니 의식적으로 결정할 수 있습니다.

롤백 규율

이전 템플릿 버전을 절대 삭제하지 마세요. 대체됨으로 표시하고 주소 지정 가능하게 유지하세요. 2주 후 다른 장면 유형에서 회귀가 나타날 때 이전 버전이 가장 빠른 참조점입니다. 네거티브 목록도 마찬가지입니다: 템플릿과 함께 버전을 관리하세요, 네거티브 항목의 변경이 포지티브 항목만큼 출력에 큰 영향을 줄 수 있기 때문입니다.

작동하는 프롬프트를 망가뜨리지 않고 반복하기

프롬프트 작업의 가장 어려운 부분은 좋은 레시피를 얻는 것이 아니라, 이미 얻은 것을 잃지 않고 개선하는 것입니다. 전형적인 실패 모드는 다섯 가지를 한 번에 바꾸고, 결과가 좋아도 어떤 변경이 효과가 있었는지 전혀 모르는 것입니다.

한 번에 하나의 변수만

하나의 슬롯 또는 하나의 네거티브 단어를 선택하세요. 나머지는 모두 고정하세요—슬롯 값, 템플릿 문자열, 버전 입력 포함. 스모크 세트를 렌더링하세요. 결정하세요. 그다음 변경으로 넘어가세요.

클립이 가깝지만 아직 이상적이지 않을 때의 실용적 처리 순서:

  • 먼저 페이싱을 조정하세요. 더 부드럽거나 느린 움직임은 다른 어떤 단일 편집보다 많은 지각 문제를 고치며, 렌더의 다른 부분을 거의 망치지 않습니다.
  • 다음 카메라를 조정하세요. 한 번에 샷 크기나 움직임 속도 중 하나의 속성만 조정하세요.
  • 세 번째로 조명을 조정하세요. 방향과 대비를 미세 조정하세요.
  • 마지막으로 피사체와 동작을 조정하세요. 간섭이 가장 크고 이전 튜닝을 무효화할 가능성이 가장 높습니다.

언제 멈출지 알기

모든 결함이 프롬프트의 결함은 아닙니다. 페이싱과 카메라에 세 번의 표적 편집을 해도 결과가 변하지 않았다면, 이 레시피에는 새로운 박자가 필요할 수 있습니다—계속 튜닝하지 말고 클립을 나누세요. 마찬가지로 한 렌더가 한 가지 지속적 결함 외에는 모두 좋다면, 프롬프트를 재구성하지 말고 정확히 하나의 네거티브 단어를 추가하세요.

루프를 짧게 유지하세요: 한 번 편집, 한 번 스모크 세트 렌더, 한 번 결정. 몇 차례를 거치면 이 규율이 진정으로 신뢰하는 프롬프트 라이브러리를 만들어 줍니다—그리고 다음 달에도 같은 결과를 렌더링할 수 있는 템플릿을.

이 레시피들을 실행할 준비가 되셨나요? HiAPI.ai의 Wan 2.7 텍스트-투-비디오 모델은 단일 통합 엔드포인트를 제공하며, 템플릿과 버전 태그를 기존 파이프라인에 바로 연결할 수 있습니다.

영구 AI 아티팩트로 빌드 시작하기

API 키를 받아 태스크 기반의 하나의 API로 이미지, 비디오, 오디오 모델을 호출하세요.

API 문서 보기