# 프롬프트 스니펫

> / 메뉴로 외모 고정이나 골든 아워 같은 검증된 프롬프트 조각을 넣고, 클릭 한 번으로 바꾸고, 내 스니펫을 저장해 모든 워크플로에서 사용하세요.

Source: https://nodaro.ai/ko/docs/guides/prompt-snippets

**프롬프트 스니펫**은 “외모 고정”, “골든 아워”, “느린 돌리 인”처럼 글을 쓰는 중에 삽입하는 재사용 가능한 프롬프트 텍스트 조각입니다. 프롬프트 필드에 `/`를 입력하거나 옆에 있는 스니펫 버튼을 클릭한 다음 스니펫을 고르세요. 스니펫의 단어가 그 위치에 들어갑니다. Nodaro는 이미지 프롬프트와 동영상 프롬프트용 기본 제공 스니펫을 제공하며, 내 스니펫을 저장할 수도 있습니다.

## 스니펫과 프리셋
| | 스니펫 | 프리셋 |
| --- | --- | --- |
| **바꾸는 것** | 필드 하나의 텍스트만 | 모델, 해상도, 화면 비율 등 노드 전체 |
| **들어가는 곳** | 작성 중인 프롬프트나 네거티브 프롬프트 안 | 노드의 모든 설정에 한 번에 |
| **용도** | 프롬프트의 문구를 풍부하게 하기 | 노드 설정하기 |

노드를 설정할 때는 [프리셋](https://nodaro.ai/docs/concepts/presets)을, 문구를 다듬을 때는 스니펫을 사용하세요.

## 보이는 그대로 실행
스니펫은 일반 텍스트입니다. 삽입하면 스니펫의 단어가 프롬프트의 일부가 되고, 그 텍스트가 그대로 모델에 전송됩니다. 나중에 따로 찾아보는 과정은 없습니다. 따라서 다음과 같습니다.

- 최종 프롬프트 보기, 게시된 앱, API, 워크플로 내보내기 모두 같은 일반 텍스트를 봅니다.
- 공유하거나 내보낸 워크플로에는 단어가 그대로 담깁니다. 워크플로를 가져온 사람에게 내 스니펫이 필요하지 않습니다.

## /로 스니펫 삽입
### 프롬프트 필드에 / 입력
줄의 처음이나 공백 뒤에 `/`를 입력하세요. 입력 중인 위치에 스니펫 메뉴가 열립니다. 단어 중간에서는 열리지 않으므로 `https://` 같은 주소를 입력해도 메뉴가 열리지 않습니다.

### 목록 필터링
계속 입력하면 목록이 필터링됩니다. 메뉴는 각 스니펫의 이름, 설명, 카테고리를 검색하며, 입력한 텍스트로 시작하는 이름이 먼저 나옵니다. 내 스니펫이 맨 위에 표시되고, 그 아래에 기본 제공 스니펫이 카테고리별로 표시됩니다. 각 행에는 이름과 텍스트 미리 보기가 있습니다. 메뉴에는 결과가 최대 50개까지 표시됩니다.

### 삽입
↑와 ↓로 이동하고, Enter 또는 Tab으로 강조된 스니펫을 삽입하세요. Esc를 누르면 메뉴가 닫히며, 일치하는 항목이 없을 때도 메뉴가 닫힙니다.

Nodaro는 프롬프트가 깔끔하게 읽히도록 스니펫 앞에 구분자를 추가합니다.

| 커서 위치 | 스니펫 앞에 추가되는 것 |
| --- | --- |
| 줄의 처음 또는 공백 뒤 | 없음 |
| `.` `,` `;` `:` `!` 또는 `?` 뒤 | 공백 하나 |
| 단어 바로 뒤 | 쉼표와 공백 |

`/` 메뉴는 다른 프롬프트 단축키와 함께 작동합니다. [멘션](https://nodaro.ai/docs/guides/reference-roles)에는 `@` 기호를, [변수](https://nodaro.ai/docs/concepts/prompt-variables)에는 `{` 기호를 씁니다.

## 스니펫 버튼
각 프롬프트 필드의 레이블 행에는 AI 프롬프트 도우미 버튼 옆에 작은 `</>` 버튼이 있습니다. 이 버튼은 같은 검색 메뉴를 엽니다. 버튼에서 고른 스니펫은 필드 끝에 추가됩니다. 다른 위치에 넣으려면 `/`를 사용하세요.

메뉴 아래쪽에는 동작이 두 가지 있습니다.

- **새 스니펫**은 새 스니펫이 준비된 상태로 스니펫 관리자를 엽니다. 필드에서 텍스트를 먼저 선택했다면 그 텍스트가 새 스니펫의 텍스트가 됩니다.
- **관리**는 스니펫 관리자를 열며, 여기에서 내 스니펫을 편집하거나 삭제할 수 있습니다.

## 스니펫 칩
프롬프트 필드에서 삽입된 스니펫은 전체 텍스트 대신 이름이 적힌 작은 호박색 **칩**으로 표시됩니다. 칩 위에 포인터를 올리면 전체 텍스트를 볼 수 있습니다. 칩은 표시만 바꿉니다. 프롬프트에는 여전히 일반 단어가 들어 있고, 프롬프트를 복사하면 그 단어가 복사됩니다.

칩을 클릭하면 메뉴가 열립니다.

| 동작 | 설명 |
| --- | --- |
| **맞바꾸기** | 골든 아워를 네온 누아르로 바꾸는 것처럼 같은 카테고리의 다른 스니펫으로 교체합니다. |
| **왼쪽 및 오른쪽 화살표** | 같은 카테고리의 다른 스니펫을 하나씩 넘겨 가며 실행 간 결과를 비교합니다. |
| **텍스트로 편집** | 칩을 다시 편집할 수 있는 텍스트로 되돌립니다. |
| **제거** | 스니펫과 그 앞에 추가된 구분자를 삭제합니다. |

칩 옆에서 Backspace를 누르면 칩 전체가 한 번에 삭제됩니다.

칩은 프롬프트 텍스트가 스니펫과 정확히 일치하는 곳마다 표시됩니다. 나중에 라이브러리에서 스니펫을 바꾸면, 예전 단어를 사용하는 이전 프롬프트에서는 그 단어가 다시 일반 텍스트로 표시됩니다. 프롬프트 자체는 바뀌지 않습니다.

## 기본 제공 스니펫
Nodaro의 기본 제공 스니펫은 이미지 프롬프트와 동영상 프롬프트, 네거티브 프롬프트를 다룹니다. 예를 들어 다음과 같은 카테고리로 묶여 있습니다.

| 카테고리 | 예시 |
| --- | --- |
| 외모 및 일관성 | 외모 고정, 의상 고정 |
| 품질 | 시네마틱 품질, 에디토리얼 사진 |
| 조명 | 골든 아워, 네온 누아르 |
| 카메라 및 렌즈 | 85mm 포트레이트, Kodak Portra 룩 |
| 구도 | 3분할 구도, 전신 프레이밍 |
| 사실성 | 실제 피부 질감, 필름 그레인 |
| 텍스트 렌더링 | 읽기 쉬운 간판 텍스트, 깔끔한 타이포그래피 |
| 카메라 모션(동영상) | 느린 돌리 인, 오비트 샷 |
| 모션 품질(동영상) | 자연스러운 물리, I2V 충실도 고정 |
| 오디오 및 대사(동영상) | 자막 없음, 무음 고정 |
| 네거티브 — 이미지 | 신체 구조 정리, 워터마크 제거 |
| 네거티브 — 동영상 | 아티팩트 제거, 외모 변화 제거 |

기본 제공 스니펫은 편집할 수 없습니다. 오디오 필드와 텍스트 필드에는 내 스니펫만 표시됩니다.

## 내 스니펫 만들기
### 스니펫 관리자 열기
프롬프트 필드 옆의 `</>` 버튼을 클릭한 다음 **새 스니펫**을 클릭하세요. 이미 쓴 텍스트에서 시작하려면 먼저 필드에서 그 텍스트를 선택하세요.

### 스니펫 내용 입력
이름과 텍스트를 입력하고 적용할 위치를 고르세요.

| 필드 | 규칙 |
| --- | --- |
| **이름** | 필수입니다. 최대 80자이며, 내 다른 스니펫의 이름과 달라야 합니다. |
| **설명** | 선택 사항입니다. 최대 300자입니다. `/` 메뉴가 설명도 검색하므로 좋은 설명이 있으면 스니펫을 찾기 쉽습니다. |
| **텍스트** | 필수입니다. 최대 2,000자입니다. 삽입되는 정확한 텍스트입니다. |
| **타깃** | 프롬프트 또는 네거티브 프롬프트입니다. |
| **미디어** | 이미지, 동영상, 오디오 또는 텍스트 노드입니다. 비워 두면 모든 노드에 스니펫이 표시됩니다. |
| **카테고리** | 선택 사항입니다. 메뉴에서 스니펫을 묶습니다. 카테고리가 없으면 **내 스니펫** 아래에 표시됩니다. |

### 저장
내 스니펫은 항상 메뉴 맨 위, 기본 제공 스니펫보다 앞에 표시됩니다.

**스니펫에 넣을 수 없는 것.** 스니펫 텍스트에는 `{`, `}`, `@`, 줄바꿈을 넣을 수 없습니다. 프롬프트 편집기는 중괄호를 변수에, `@` 기호를 멘션에 사용하므로 이 문자들이 들어가면 텍스트가 변수나 멘션으로 바뀔 수 있습니다.

## 필드에 표시되는 스니펫
각 스니펫에는 타깃(프롬프트 또는 네거티브)과 하나 이상의 노드 종류(이미지, 동영상, 오디오 또는 텍스트)가 있습니다. 필드에는 둘 다 일치하는 스니펫만 표시됩니다. “느린 돌리 인” 같은 동영상 스니펫은 이미지 프롬프트에 나타나지 않고, 네거티브 스니펫은 일반 프롬프트 필드에 나타나지 않습니다.

**네거티브 프롬프트 필드**에도 같은 `/` 메뉴가 있으며, 네거티브 스니펫이 표시됩니다. 네거티브 스니펫은 `morphing, warping, flickering` 같은 짧은 쉼표 목록입니다. 칩 없이 일반 텍스트로 삽입됩니다.

**오디오 태그 필드**, 즉 음성 노드와 Suno 음악 노드의 텍스트 필드는 `/`를 오디오 태그에 사용하므로 스니펫을 표시하지 않습니다.

## 최종 프롬프트 보기
모든 프롬프트 필드와 네거티브 프롬프트 필드의 레이블 행에는 눈 아이콘 모양의 **최종 프롬프트 보기** 버튼이 있습니다. 이 버튼을 누르면 편집기가 모델이 받을 전체 프롬프트로 바뀌고, **복사** 버튼이 함께 표시됩니다. 연필을 클릭하면 **프롬프트 편집**으로 돌아갑니다. 보기 상태는 필드마다 기억되며 워크플로와 함께 저장됩니다.

이미지 생성과 이미지 수정에서는 최종 보기가 각 부분을 출처에 따라 색으로 구분합니다.

| 색 | 텍스트의 출처 |
| --- | --- |
| 색 없음 | 내가 쓴 텍스트 |
| 하늘색 | 다른 노드에서 채워진 `{Mood}` 같은 변수 |
| 남색 | 연결된 피커 |
| 호박색 | 스니펫 |
| 청록색 | 노드의 [앞뒤 텍스트](https://nodaro.ai/docs/concepts/prompt-pre-post-text) |
| 보라색 | 연결된 캐릭터와 이미지의 레퍼런스 문구 |
| 회색 | 끝에 추가되는 스타일 |
| 장미색 | 모델에 별도의 네거티브 필드가 없을 때의 네거티브 프롬프트 |

다른 노드도 가능한 곳에서는 같은 부분에 색을 입힙니다. 색은 표시용일 뿐입니다. **복사**는 항상 일반 텍스트를 복사하고, 모델도 일반 텍스트를 받습니다.

네거티브 프롬프트 필드에는 네거티브 프롬프트가 어떻게 전송되는지도 표시됩니다. 일부 모델은 실제 네거티브 프롬프트를 받습니다. 그 밖의 모델에는 Nodaro가 네거티브 프롬프트를 `Avoid:` 줄로 프롬프트 끝에 추가합니다.

## 코드에서 스니펫 사용
스니펫은 에디터에서 관리합니다. REST API로는 스니펫을 읽을 수 있습니다. `GET /v1/prompt-snippets`는 내 스니펫을, `GET /v1/prompt-snippets/factory`는 기본 제공 스니펫을 나열합니다. 스니펫을 만들고, 편집하고, 삭제하는 작업은 에디터에서만 할 수 있습니다. 스니펫이 들어간 워크플로를 실행할 때는 특별히 할 일이 없습니다. 단어가 이미 프롬프트에 들어 있기 때문입니다.

## 자주 묻는 질문

### 프롬프트 스니펫이란 무엇인가요?

스니펫은 골든 아워나 느린 돌리 인처럼 재사용할 수 있는 프롬프트 텍스트 조각입니다. 글을 쓰는 중에 삽입하면 스니펫의 단어가 보이는 그대로 프롬프트의 일부가 됩니다.

### 스니펫과 프리셋은 어떻게 다른가요?

프리셋은 모델, 해상도, 화면 비율 같은 노드 전체를 설정합니다. 스니펫은 프롬프트나 네거티브 프롬프트 안에서 작성 중인 텍스트만 바꿉니다.

### 내 워크플로를 가져오는 사람에게도 내 스니펫이 필요한가요?

아니요. 스니펫은 프롬프트에 일반 텍스트로 저장되므로 단어가 워크플로와 함께 전달됩니다. 워크플로를 가져온 사람도 같은 프롬프트를 봅니다.

### 기본 제공 스니펫을 편집할 수 있나요?

아니요. 기본 제공 스니펫은 편집할 수 없습니다. 새 스니펫으로 내 스니펫을 만드세요. 원한다면 기본 제공 텍스트에서 시작할 수 있습니다.

### 스니펫에 넣을 수 없는 문자는 무엇인가요?

프롬프트 편집기가 변수와 멘션에 중괄호, @ 기호, 줄바꿈을 사용하므로 스니펫에는 이 문자들을 넣을 수 없습니다.