UGC 카드 노드: UGC 동영상의 스크린샷 카드와 자막을 크리에이터의 말에 맞추기

UGC 동영상의 스크린샷 카드와 자막을 크리에이터의 말에 맞추고, 각 클립이 자기 줄을 말했는지 확인해 실행에 대한 알기 쉬운 메모를 남깁니다.

UGC 카드 노드는 UGC 동영상의 스크린샷 카드와 자막을 크리에이터의 말에 맞춥니다. 동영상 합치기로 UGC 클립의 클립을 합친 동영상을 대상으로 작업합니다. 각 클립이 자기 줄을 말했는지도 확인하고 메모를 씁니다.

UGC 카드는 각 단어가 말해지는 시점을 찾습니다. 이를 바탕으로 두 가지의 타이밍을 맞춥니다.

스크린샷 카드. 크리에이터가 각 스크린샷에 대해 말하는 동안 그 스크린샷이 나타납니다. 카드는 동영상 오버레이용 레이어 플랜으로 출력됩니다.
자막. 플랜에는 첫 줄과 첫 줄이 끝나는 지점, 나머지 부분의 타이밍이 맞춰진 단어가 담깁니다. 자막은 자막 추가용 캡션 플랜으로 출력됩니다. 자막 추가는 첫 줄을 훅 플레이트 스타일로, 나머지는 자체 캡션 스타일로 그립니다.

UGC 카드는 Nodaro Cloud에서만 실행됩니다. 다른 설치에서는 모든 UGC 노드가 아무것도 예약되기 전에 “UGC 동영상은 Nodaro Cloud 기능이라 이 인스턴스에서는 제공되지 않습니다.”라는 메시지와 함께 실패합니다.

사용 시기

UGC 동영상의 클립을 합쳤고, 스크린샷 카드와 자막을 음성에 맞추고 싶을 때.
실행에 대한 알기 쉬운 문장으로 어떤 클립을 다시 렌더링할지 알고 싶을 때.

빠른 시작

노드 추가

캔버스에서 Tab을 누르고 동영상 › UGC 동영상 › UGC 카드를 선택하세요.

입력 연결

UGC 클립 목록의 스크립트(길이 조정됨) 출력과 녹취록 출력을 스크립트와 녹취록에 연결하세요. 동영상 합치기에서 나온 합친 동영상을 동영상에 연결하세요. UGC 클립의 동영상 출력을 클립 메모에 연결하세요.

플랜 연결

레이어 플랜을 동영상 오버레이의 레이어 플랜 입력에 연결하세요. 캡션 플랜을 자막 추가의 캡션 플랜 입력에 연결하세요.

실행 후 메모 확인

워크플로를 실행하세요. 노드나 설정 패널에서 메모를 읽으세요.

UGC 카드가 합친 동영상과 클립의 메모를 읽습니다. 동영상 오버레이가 스크린샷 카드를 그리고, 자막 추가가 그 결과에 자막을 그립니다.

입력

입력	필수	연결할 것
스크립트	예	UGC 클립 목록의 스크립트(길이 조정됨) 출력입니다. 다른 것을 연결하면 타이밍 작업이 시작되기 전에 노드가 ““UGC 클립 목록”의 “스크립트(길이 조정됨)” 출력을 연결하세요.”라는 메시지와 함께 실패합니다.
동영상	예	동영상 합치기에서 나온 합친 동영상입니다. 없으면 노드가 “합친 동영상을 연결하세요.”라는 메시지와 함께 실패합니다.
녹취록	예	UGC 클립 목록의 녹취록 출력입니다. 없으면 노드가 ““UGC 클립 목록”의 “녹취록” 출력을 연결하세요.”라는 메시지와 함께 실패합니다.
클립 메모	아니요	UGC 클립의 동영상 출력입니다. UGC 카드는 각 클립의 경고와 실제 길이를 읽습니다. 보이스에 맞춰 늘어난 클립은 음성 확인 구간을 옮깁니다. 이 입력이 없으면 메모에 클립에 대한 내용이 없습니다.

출력

출력	전달하는 것
레이어 플랜	JSON 형식의 스크린샷 카드로, 동영상 오버레이의 레이어 플랜 입력에 씁니다.
캡션 플랜	JSON 형식의 자막으로, 자막 추가의 캡션 플랜 입력에 씁니다.
메모	한 줄에 한 문장씩인 일반 텍스트입니다. 게시된 앱에서는 메모가 텍스트 출력이 됩니다.

설정

UGC 카드에는 설정이 없습니다. 설정 패널에는 마지막 실행의 메모가 표시됩니다.

단어 타이밍 방식

단어 타이밍은 클립의 단어를 합친 동영상에 맞춰 정렬한 단어 정렬에서 나옵니다.

정렬이 실패하거나 단어를 찾지 못하면, 대신 음성 인식으로 카드와 자막의 타이밍을 맞춥니다.
음성 텍스트 변환이 실패하거나 단어가 들리지 않으면 음성 확인이 실행되지 않습니다.
동영상의 클립을 서로 구분할 수 없을 때도 음성 확인이 실행되지 않습니다.
아무것도 타이밍을 맞출 수 없으면 두 플랜이 모두 비게 됩니다. 그러면 동영상 오버레이와 자막 추가가 동영상을 비용 없이 그대로 통과시킵니다.

이 중 어떤 일이 일어났는지는 메모에 표시됩니다.

메모

“문제가 없습니다.”는 문제가 없고 모든 확인, 즉 각 클립의 자체 확인과 음성 확인이 실행되었을 때만 표시됩니다. 실행되지 않은 확인에는 항상 별도의 문장이 표시됩니다.

상황	문장
스크린샷이 없거나, 스크립트가 사용하지 않는 1~2장뿐일 때	스크린샷 카드가 없습니다. 크리에이터가 말하는 동영상입니다. 카드를 넣으려면 스크린샷을 3~8장 추가하세요.
단어 정렬이 실패했거나 단어를 찾지 못했을 때	자막과 카드의 타이밍을 음성 인식으로 맞췄습니다.
음성 텍스트 변환이 실패했거나 단어가 들리지 않았을 때	음성 확인이 실행되지 않았습니다. 음성을 텍스트로 변환할 수 없었습니다.
동영상의 클립을 서로 구분할 수 없어 어떤 클립의 단어도 확인할 수 없었을 때	음성 확인이 실행되지 않았습니다. 동영상의 클립을 서로 구분할 수 없었습니다.
아무것도 타이밍을 맞출 수 없었을 때	카드와 자막이 없습니다. 음성 타이밍을 맞출 수 없었습니다.
카드가 마지막 줄을 가릴 뻔했을 때	카드 n을 제외했습니다. 마지막 줄을 가리기 때문입니다.
클립이 확인에 두 번 실패했을 때	클립 n은 한 번 다시 렌더링한 뒤에도 문제가 있었습니다(확인 결과). UGC 클립 노드에서 다시 렌더링하세요.
클립이 확인에 실패했지만 다시 렌더링할 여유가 없었을 때	클립 n에 문제가 있었지만(확인 결과) 다시 렌더링할 여유가 없었습니다. UGC 클립 노드에서 다시 렌더링하세요.
클립의 다시 렌더링이 실패했을 때	클립 n의 다시 렌더링이 실패해 첫 렌더링을 유지합니다.
클립의 자동 확인을 실행할 수 없어 확인 없이 클립을 유지했을 때	클립 n을 자동 확인 없이 유지했습니다. 이번에는 확인을 실행할 수 없었습니다. 클립을 보고, 문제가 있어 보이면 UGC 클립 노드에서 다시 렌더링하세요.
클립의 음성이 줄과 맞지 않았을 때	클립 n이 줄을 정확히 말하지 않았을 수 있습니다. 들린 내용: “들린 내용”
클립이 보이스에 맞춰 늘어났을 때	클립 n을 보이스에 맞춰 늘렸습니다.
문제가 없고 모든 확인이 실행되었을 때	문제가 없습니다.

크레딧

UGC 카드에는 자체 가격이 없습니다. 합친 동영상에서 작업 두 개를 실행하며, 각각 자체 가격이 청구됩니다.

단어 정렬 작업 하나: 강제 정렬의 가격인 33크레딧
음성 텍스트 변환 작업 하나: 자체 가격으로 청구

크레딧이 두 작업을 모두 충당할 수 없으면 노드가 일반적인 크레딧 부족 거부와 함께 멈춥니다. 카드가 자막 없이 만들어지는 일은 없습니다. 노드는 먼저 UGC 경로가 제공되는지 비용 없이 확인하므로, 제공되지 않는 곳에서는 아무것도 청구되지 않습니다.

편집기는 실행 전체의 가격을 시작 전에 표시합니다. 편집기의 가격을 참고하세요.

팁

실행할 때마다 메모를 읽으세요. 줄을 정확히 말하지 않았을 수 있는 클립이나 여전히 문제가 있었던 클립을 UGC 클립에서 다시 렌더링하세요.
UGC 클립을 클립 메모에 연결하세요. 연결하지 않으면 메모에 클립에 대한 내용이 없습니다.
게시할 때 카드와 메모는 포함되지 않습니다. 이번 실행 결과 포함으로 게시한 템플릿은 카드와 메모를 예시로 보여 줍니다.

문제 해결

메시지 또는 문제	원인과 해결
““UGC 클립 목록”의 “스크립트(길이 조정됨)” 출력을 연결하세요.”	스크립트가 비어 있거나 UGC 스크립트 같은 다른 노드의 출력이 연결되어 있습니다. UGC 클립 목록의 스크립트(길이 조정됨) 출력을 연결하세요.
“합친 동영상을 연결하세요.”	동영상 합치기에서 나온 합친 동영상을 동영상에 연결하세요.
““UGC 클립 목록”의 “녹취록” 출력을 연결하세요.”	UGC 클립 목록의 녹취록 출력을 녹취록에 연결하세요.
동영상에 카드가 없습니다.	UGC 스크립트에 연결된 스크린샷이 3장보다 적습니다. 스크린샷을 3~8장 추가하세요.
동영상에 카드도 자막도 없습니다.	음성 타이밍을 맞출 수 없었습니다. 메모에 그렇게 표시됩니다. 합친 동영상에 크리에이터의 음성이 있는지 확인하세요.
메모에 클립에 대한 내용이 없습니다.	UGC 클립의 동영상 출력을 클립 메모에 연결하세요.

API에서 사용

UGC 카드는 실행될 때 POST /v1/ugc/cards를 호출합니다. 첫 호출은 GET /v1/ugc/categories이며, 무료로 UGC 경로가 제공되는지 확인합니다. UGC 경로의 요청과 응답 형식은 노드에 속하며 버전에 따라 바뀔 수 있습니다. 코드로 UGC 동영상을 만들려면 UGC 노드가 들어 있는 워크플로나 게시된 앱을 실행하세요.

API 실행 결과에서 메모는 UGC 카드의 text입니다. 워크플로와 실행을 참고하세요.

MCP로 연결된 AI 어시스턴트는 build_ugc_cards 같은 별도의 UGC 도구를 사용합니다. get_recipe로 불러오는 ugc-website 레시피가 이 도구를 설명합니다. 콘텐츠 레시피를 참고하세요.

자주 묻는 질문

UGC 카드 노드는 무엇을 하나요?

UGC 카드는 합친 UGC 동영상에서 각 단어가 말해지는 시점을 찾습니다. 이를 바탕으로 동영상 오버레이용 스크린샷 카드와 자막 추가용 자막의 타이밍을 맞춥니다. 각 클립의 음성도 확인하고 메모를 씁니다.

UGC 카드는 크레딧이 얼마나 드나요?

UGC 카드에는 자체 가격이 없습니다. 합친 동영상에서 단어 정렬 작업 하나와 음성 텍스트 변환 작업 하나를 실행하며, 각각 자체 가격이 청구됩니다.

메모란 무엇인가요?

메모는 계획대로 되지 않은 일을 한 줄에 한 문장씩 적은 알기 쉬운 문장입니다. 예를 들어 줄을 정확히 말하지 않았을 수 있는 클립을 알려 줍니다. 문제가 없고 모든 확인이 실행되었으면 “문제가 없습니다.”라고 표시됩니다.

UGC 동영상에 스크린샷 카드가 없는 이유는 무엇인가요?

UGC 스크립트에 스크린샷이 3~8장 있어야 동영상에 카드가 나옵니다. 없거나 1~2장이면 크리에이터가 말하는 동영상이 되며, 메모에 그렇게 표시됩니다.

음성 타이밍을 맞출 수 없으면 어떻게 되나요?

두 플랜이 모두 비게 됩니다. 그러면 동영상 오버레이와 자막 추가가 동영상을 비용 없이 그대로 통과시키고, 메모에 음성 타이밍을 맞출 수 없었다고 표시됩니다.

UGC 카드

자주 묻는 질문

관련 문서

동영상 오버레이

자막 추가

UGC 클립

UGC 클립 목록

강제 정렬

목차