# 대본 생성

> AI로 여러 장면의 동영상 대본을 쓰세요. 장면마다 설명, 액션, 분위기, 길이, 카메라, 대사, 바로 쓸 수 있는 이미지 프롬프트가 담깁니다.

Source: https://nodaro.ai/ko/docs/nodes/video/generate-script

**대본 생성** 노드는 짧은 프롬프트로 구조화된 여러 장면의 동영상 대본을 씁니다. 각 장면에는 시각적 설명, 액션, 분위기, 권장 길이, [이미지 생성](https://nodaro.ai/docs/nodes/image/generate-image)에 바로 쓸 수 있는 이미지 프롬프트가 있고, 해당하는 경우 카메라 연출, 대사, 장소 정보, 음악 분위기, 효과음도 담깁니다. 출력 일곱 개가 대본의 각 부분을 그 부분이 필요한 노드로 보냅니다.

- Found in: Video › Story & Script
- Output: text
- API type: `generate-script`

## 사용 시기
- 동영상의 스토리보드가 필요할 때. 장면마다 이미지 프롬프트를 하나씩 만들고, 그다음 장면마다 이미지 하나와 클립 하나를 만듭니다.
- 설명 동영상, 광고, 제품 데모, 소셜 동영상을 위한 구조화된 대본이 필요할 때.
- 대사, 음악 분위기, 효과음을 화면과 함께 계획하고 싶을 때.
- 생성에 크레딧을 쓰기 전에 동영상의 길이와 페이스를 계획하고 싶을 때.

프롬프트 하나로 완성된 영상을 통째로 만들려면 [스토리 → 동영상](https://nodaro.ai/docs/nodes/video/story-to-video)을 쓰세요.

## 빠른 시작
### 노드 추가
캔버스에서 Tab을 누르고 **동영상 › 스토리 및 대본 › 대본 생성**을 선택하세요.

### 동영상 설명
[텍스트](https://nodaro.ai/docs/nodes/automate/text) 노드를 추가하고 주제, 이야기 또는 콘셉트를 입력한 다음, 대본 생성의 **프롬프트** 입력에 연결하세요. 구체적으로 적으세요. “동영상 만들어 줘”보다 “아침 루틴을 보여 주는 피트니스 앱의 30초 제품 광고”가 더 잘 통합니다.

### 대본 형태 설정
설정 패널을 여세요. **장면 수**와 <strong>목표 길이(초)</strong>를 정하고, 원하면 **톤**과 **스타일 가이드**도 정하세요.

### 실행 후 출력 연결
**실행**을 클릭하세요. 대본이 노드에 나타납니다. 출력을 화면, 목소리, 음악을 만드는 노드에 연결하세요.

Workflow: 대본 생성이 아이디어를 장면으로 바꾸고, 그 출력이 장면마다 이미지 하나, 대사, 음악으로 이어집니다.

- 텍스트 → 대본 생성 (프롬프트)
- 대본 생성 → 이미지 생성 (이미지)
- 대본 생성 → 텍스트로 대화 만들기 (대사)
- 대본 생성 → 음악 생성 (음악)

## 입력과 출력
대본 생성의 왼쪽 가장자리에는 입력이 다섯 개 있습니다.

| 입력 | 연결할 수 있는 노드 | 설명 |
| --- | --- | --- |
| **프롬프트** | [텍스트](https://nodaro.ai/docs/nodes/automate/text)나 [텍스트 생성 - 모든 LLM](https://nodaro.ai/docs/nodes/automate/prompt) 같은 텍스트 노드 | 주제, 이야기 또는 콘셉트입니다. 필수입니다. 이 노드에는 자체 프롬프트 입력란이 없습니다. |
| **톤** | [톤](https://nodaro.ai/docs/nodes/settings/tone) 노드 또는 아무 텍스트 노드 | **톤**을 정합니다. |
| **스타일 가이드** | [스타일 가이드](https://nodaro.ai/docs/nodes/settings/style-guide) 노드 또는 아무 텍스트 노드 | **스타일 가이드**를 정합니다. |
| **장면 수** | [장면 수](https://nodaro.ai/docs/nodes/settings/scene-count) 노드 | **장면 수**를 1~20으로 정합니다. |
| **길이** | [길이](https://nodaro.ai/docs/nodes/settings/duration) 노드 | <strong>목표 길이(초)</strong>를 5~600으로 정합니다. |

연결된 입력은 패널에 입력한 값보다 우선합니다. 연결되어 있는 동안 패널에서 그 필드는 읽기 전용이 되고, 연결된 노드 이름이 적힌 칩이 표시됩니다. 이 입력에서 연결선을 끌어내면 해당 노드가 추가됩니다.

출력 일곱 개는 각각 현재 대본의 한 부분을 담습니다.

| 출력 | 담는 내용 | 연결 대상 |
| --- | --- | --- |
| **장면** | 텍스트로 된 대본으로, 첫 장면의 이미지 프롬프트입니다. | 텍스트 입력. |
| **이미지** | 모든 장면의 이미지 프롬프트입니다. | [이미지 생성](https://nodaro.ai/docs/nodes/image/generate-image)의 **프롬프트** 입력. 장면이 두 개 이상이면 이미지 생성이 장면마다 한 번씩 실행됩니다. |
| **대사** | 대본의 모든 대사 줄과 화자, 감정입니다. | [텍스트로 대화 만들기](https://nodaro.ai/docs/nodes/audio/text-to-dialogue). 그 설정에서 **대본에서 대사 N줄 채우기**를 클릭하면 대사가 복사됩니다. 텍스트로 대화 만들기에 자체 대사가 없으면 실행할 때 대본의 대사를 씁니다. |
| **음악** | 모든 장면의 음악 분위기를 중복 없이 모아 한 텍스트로 합친 것입니다. | [음악 생성](https://nodaro.ai/docs/nodes/audio/generate-music)의 프롬프트. |
| **효과음** | 모든 장면의 효과음을 한 텍스트로 합친 것입니다. | [텍스트로 오디오 만들기](https://nodaro.ai/docs/nodes/audio/text-to-audio)의 프롬프트. |
| **캐릭터** | 대본의 캐릭터를 중복 없이 이름, 설명, 분위기, 액션, 위치와 함께 담습니다. | 대본 캐릭터를 읽는 노드. |
| **장소** | 대본의 장소를 중복 없이 이름, 설명, 시간대, 날씨, 조명과 함께 담습니다. | 대본 장소를 읽는 노드. |

## 설정
| 설정 | 설명 |
| --- | --- |
| **AI 모델** | 대본을 쓰는 텍스트 모델입니다. 기본값은 Gemini 3.6 Flash입니다. 이름, 회사, 등급으로 검색하세요. |
| **추론 강도** | 지원하는 모델에서, 모델이 쓰기 전에 얼마나 생각할지 정합니다. |
| **고급 모드** | Gemini와 Claude 모델에서 쓸 수 있습니다. 모델 제작사의 자체 컨트롤로 모델을 실행하므로 **온도**, **최대 토큰 수**, 전체 추론 범위가 적용됩니다. 켜면 이 컨트롤이 나타납니다. 한 크레딧 등급 더 비싸며, 프리미엄 모델은 제작사에서 직접 실행하므로 83크레딧이 됩니다. Claude 모델에서는 **추론 강도**를 하나라도 선택하면 같은 방식, 같은 가격으로 실행됩니다. 다른 모델에서는 스위치가 비활성화되고 그 이유가 표시됩니다. |
| **장면 수** | 쓸 장면 수로, 1~20입니다. 기본값은 5입니다. **장면 수** 입력으로 정할 수 있습니다. |
| **스타일 가이드** | 색 팔레트, 시대, 시각적 레퍼런스처럼 모든 장면에 적용할 시각적, 서사적 방향입니다. 주제와 함께 모델에 보내지며, 다른 노드를 `{Node Label}` 형식으로 참조할 수 있습니다. **스타일 가이드** 입력으로 정할 수 있습니다. |
| **톤** | 대본 전체의 감정 톤으로, 예를 들어 기발함, 극적임, 교육적임 같은 것이며 최대 200자입니다. **톤** 입력으로 톤 노드나 아무 텍스트 노드에서 정할 수 있습니다. |
| **목표 길이(초)** | 대본이 계획할 전체 길이로, 5~600초입니다. 기본값은 60입니다. AI가 장면들에 나누어 배분하므로, 장면마다 길이가 다를 수 있습니다. **길이** 입력으로 정할 수 있습니다. |
| **앞뒤 텍스트** | 노드가 실행될 때 프롬프트 앞뒤에 추가되는 텍스트이며, 스타일 가이드에는 추가되지 않습니다. 내 워크플로를 앱으로 사용하는 사람에게는 보이지 않습니다. [프롬프트 앞뒤 텍스트](https://nodaro.ai/docs/concepts/prompt-pre-post-text)를 참조하세요. |

여러 대본에서 이 값을 한곳에서 관리하려면, 값을 입력하는 대신 [생성 설정](https://nodaro.ai/docs/nodes/settings) 노드를 해당 입력에 연결하세요.

## 각 장면의 구성
| 부분 | 내용 |
| --- | --- |
| 장면 번호와 이름 | 장면의 순서와 짧은 이름입니다. |
| 시각적 설명 | 보이는 것에 대한 자세한 설명입니다. |
| 액션 | 장면에서 일어나는 일입니다. |
| 분위기 | 하나 이상의 감정 톤입니다. |
| 길이 | 초 단위의 권장 길이입니다. |
| 이미지 프롬프트 | 이미지 생성에 바로 쓸 수 있는 프롬프트입니다. |
| 캐릭터 | 각 캐릭터의 이름, 설명, 분위기, 액션, 위치입니다. |
| 대사 | 말하는 대사로, 각각 화자, 텍스트, 감정이 있습니다. |
| 장소 | 이름, 설명, 시간대, 날씨, 조명입니다. |
| 촬영 기법 | 샷 유형, 카메라 앵글, 카메라 움직임입니다. |
| 음악 분위기와 효과음 | 사운드트랙에 대한 제안입니다. |

## 대본 편집
실행 후 설정 패널에 생성된 대본이 표시됩니다. **제목**, 장면 수와 전체 길이, 그리고 장면마다 섹션이 하나씩 있습니다. 장면을 열어 **시각적 설명**, **액션**, **분위기**, **길이(초)**, <strong>이미지 프롬프트(“이미지 생성”용)</strong>를 편집하세요. 출력은 편집한 내용을 보냅니다. **프롬프트 복사**는 모든 장면의 이미지 프롬프트를 복사합니다.

모든 실행은 노드의 결과 스트립에 보관되며, 출력은 선택한 결과를 따릅니다.

대본이 만들어지면 노드의 **스토리보드 크게 보기**로 모든 장면의 워크플로 노드를 만들 수 있습니다. 장면마다 장면 노드를 하나씩 만드는 **장면 노드**나, 장면마다 이미지 생성, 동영상, 텍스트 음성 변환, 동영상 및 오디오 병합 노드를 따로 만드는 **파이프라인 노드**를 고르세요. 끝에 동영상 합치기 노드를 추가하고 이미지 생성을 바로 시작할 수도 있습니다. 대화 상자는 노드를 만들기 전에 예상 크레딧을 보여 줍니다.

## 프리셋
노드에서 **프리셋**을 열면 톤, 장면 수, 목표 길이를 정하는 형식 프리셋이 있습니다. 주제는 프롬프트에 입력하세요.

| 폴더 | 프리셋 |
| --- | --- |
| **형식별** | YouTube 쇼츠 / 훅, 설명 동영상(하우투), 광고 / CF 스폿, 제품 데모 내레이션, 리스티클(톱 5), 셀카 스타일의 UGC 광고(훅–시연–증거–의견, 수치와 근거는 내 주제에서만 가져옴) |
| **롱폼 및 내러티브** | 팟캐스트 구성안, 예고편 내레이션, 스토리 비트 |

## 크레딧
실행 한 번에 AI 모델의 등급인 이코노미, 표준, 프리미엄에 따라 11크레딧, 22크레딧 또는 33크레딧이 듭니다. 기본 모델인 Gemini 3.6 Flash는 이코노미 모델입니다. 추론 강도 **매우 높음**과 **최대**는 한 등급 더 비싸지만, 프리미엄 모델의 가격은 바뀌지 않습니다. **고급 모드**도 한 등급 더 비쌉니다. 고급 모드의 프리미엄 모델은 제작사에서 직접 실행하므로 83크레딧이 듭니다. Claude 모델에서는 어떤 추론 강도든 고급 모드와 같은 가격이 매겨집니다. 고급 모드를 켜면 노드의 비용 배지가 갱신됩니다. 등급은 [모델 선택](https://nodaro.ai/docs/guides/choosing-models)을 참조하세요.

## 팁
- **프롬프트를 구체적으로 쓰세요.** 제품, 대상, 길이, 형식을 적으세요.
- **일관성을 위해 톤을 쓰세요.** 톤은 모든 장면에 적용되므로 대본 전체가 하나의 감정 톤을 유지합니다.
- **룩은 스타일 가이드에 넣으세요.** 팔레트, 시대, 시각적 레퍼런스가 이미지 프롬프트의 일관성을 지켜 줍니다.
- **길이는 계획으로 생각하세요.** 목표 길이는 AI의 기준이 되지만, 각 장면의 길이는 내용에 따라 달라질 수 있습니다.

## 문제 해결
**실행이 “needs a topic”(주제가 필요함) 또는 “프롬프트가 없습니다.”라는 메시지와 함께 멈춥니다.** 대본이 다룰 주제가 없습니다. 주제, 이야기 또는 콘셉트를 담은 [텍스트](https://nodaro.ai/docs/nodes/automate/text) 노드를 **프롬프트** 입력에 연결하세요. 톤, 스타일 가이드, 장면 수, 길이 입력은 설정만 정하며 주제가 되지 않습니다. 실행이 시작되기 전에 멈추므로 아무것도 청구되지 않습니다.

## API에서 사용
`POST /v1/generate-script`로 코드에서 대본을 쓸 수 있습니다. 바로 `jobId`로 응답합니다. 완성된 대본은 작업의 `output_data.script`에 `title`, `totalDuration`, `scenes`와 함께 담깁니다. [작업](https://nodaro.ai/docs/developers/api/jobs)을 참조하세요.

| 필드 | 설명 |
| --- | --- |
| `prompt` | 필수입니다. 주제, 이야기 또는 콘셉트로, 최대 100,000자입니다. |
| `sceneCount` | **장면 수**로, 1~20입니다. 기본값은 5입니다. |
| `targetDuration` | <strong>목표 길이(초)</strong>로, 5~600입니다. 기본값은 60입니다. |
| `tone` | **톤**으로, 최대 200자입니다. |
| `styleGuide` | **스타일 가이드**로, 최대 100,000자입니다. |
| `llmModel` | 텍스트 모델입니다. 기본값은 `gemini-3.6-flash`입니다. |
| `reasoningEffort` | `none`, `low`, `medium`, `high`, `xhigh` 또는 `max`입니다. |
| `advancedMode`, `temperature`, `maxTokens` | **고급 모드**와 그 컨트롤로, Gemini와 Claude 모델에서 쓸 수 있습니다. |

MCP 도구는 [`generate_script`](https://nodaro.ai/docs/mcp/tools/prompts-and-text#generate_script)이며, 스타일 가이드를 `style_guide`로 받습니다. [노드 하나 실행](https://nodaro.ai/docs/developers/api/nodes)도 참조하세요.

## 자주 묻는 질문

### 대본 생성 노드는 무엇을 만드나요?

제목, 전체 길이, 장면 목록이 있는 구조화된 대본을 만듭니다. 각 장면에는 시각적 설명, 액션, 분위기, 권장 길이, 이미지 프롬프트가 있고, 필요하면 캐릭터, 대사, 장소, 카메라, 음악 분위기, 효과음도 담깁니다.

### 장면마다 이미지를 하나씩 만들려면 어떻게 하나요?

대본 생성의 이미지 출력을 이미지 생성 노드의 프롬프트 입력에 연결하세요. 대본에 장면이 두 개 이상이면 이미지 생성이 장면마다 그 장면의 이미지 프롬프트로 한 번씩 실행됩니다.

### 대본 생성은 크레딧이 얼마나 드나요?

AI 모델의 등급에 따라 실행당 11~83크레딧이 듭니다. 이코노미 모델은 11크레딧, 표준은 22크레딧, 프리미엄은 33크레딧입니다. 추론 강도 매우 높음과 최대는 한 등급 더 비싸지만, 프리미엄 모델의 가격은 바뀌지 않습니다. 고급 모드는 한 등급 더 비싸며, 고급 모드의 프리미엄 모델은 83크레딧입니다.

### 장면을 몇 개로 요청해야 하나요?

대부분의 형식에서는 동영상 5~10초마다 장면 하나 정도가 잘 맞습니다. 장면 수는 1~20을 받으며, 목표 길이는 AI가 계획할 전체 길이를 정합니다.