UGC 스크립트

UGC 스크립트 노드는 UGC 동영상에서 크리에이터가 말할 내용인 첫 줄, 파트, 마지막 줄을 씁니다. 최대 8장의 스크린샷과 입력한 제품 이름이나 웹사이트를 읽습니다. 스크립트가 동영상 규칙에 맞는지 확인하고, 규칙을 어기면 스크립트를 다시 씁니다.

UGC 스크립트는 UGC 크리에이터가 크리에이터를 만들 때 쓰는 제품 카테고리도 고릅니다. 보통 다음 노드는 스크립트를 클립으로 나누는 UGC 클립 목록입니다.

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

사용 시기

• 크리에이터가 내 제품이나 웹사이트에 대해 말하는 짧은 동영상을 원할 때.
• 사이트나 앱의 스크린샷이 있고, 크리에이터가 언급할 때마다 각 스크린샷을 카드로 보여 주고 싶을 때.
• 동영상 길이에 이미 맞춘 스크립트가 필요할 때.

이미지 프롬프트, 대사, 음악 분위기가 있는 여러 장면의 스크립트가 필요하면 대본 생성을 사용하세요.

빠른 시작

입력

스크린샷 개수

• 스크린샷 3~8장: 입력 순서대로, 스크린샷 1부터 한 장에 파트 하나씩입니다. 크리에이터가 그 내용을 말하는 동안 각 스크린샷이 카드로 나타납니다. 카드 타이밍은 UGC 카드가 맞춥니다.
• 스크린샷 1~2장은 사용되지 않습니다. 카드 없이 크리에이터가 말하는 동영상이 되며, UGC 카드의 메모에 그렇게 표시됩니다.
• 스크린샷 없음: 똑같이 크리에이터가 말하는 동영상이 됩니다.

UGC 스크립트는 스크린샷을 이미지로 읽습니다. 웹사이트를 방문하지 않습니다.

출력

설정

설정에는 스크립트를 몇 번 만에 작성했는지도 “2회 만에 작성”처럼 표시됩니다.

스크립트 확인 방식

UGC 스크립트는 스크립트가 동영상 규칙에 맞는지 확인합니다. 규칙을 어기면 노드가 확인 결과를 바탕으로 스크립트를 다시 씁니다. 처음 작성과 최대 두 번의 재작성을 합쳐 모두 세 번 시도합니다.

줄 편집

실행 후 설정에 스크립트의 줄이 표시됩니다. 첫 줄, 각 파트(파트 1, 파트 2 등), 마지막 줄입니다.

1. 편집을 누르고 줄의 문구를 바꾸세요.
2. 저장을 누르면 스크립트에 반영됩니다. 저장하면 이 스크립트 유지가 켜지므로 다음 실행에서 편집한 줄을 사용합니다.
3. 스크립트를 그대로 두려면 취소를 누르세요.

편집할 수 있는 것은 줄의 문구뿐입니다. 빈 줄은 “파트 2의 줄이 비어 있습니다.”와 같은 메시지와 함께 거부됩니다. 스크립트의 글자 수 제한을 넘는 줄도 “파트 2의 줄이 너무 깁니다. …자 이하로 입력하세요.”와 같은 메시지와 함께 거부됩니다.

UGC 클립 목록은 클립 비용을 지불하기 전에 편집한 스크립트를 다시 확인합니다. 규칙을 어긴 스크립트는 UGC 클립 목록에서 “스크립트를 수정해야 합니다:”라는 메시지와 각 문제 및 해결 방법과 함께 실패합니다.

게시된 앱에서

길이는 앱 입력 동영상 길이(초)로 만들 수 있습니다. 4~300초 슬라이더이거나, 앱에서 허용하는 길이 중에서 고르는 방식입니다. 내 사이트로 만드는 UGC 동영상 튜토리얼을 앱으로 게시하면 15초, 20초, 25초를 제공합니다.

크레딧

UGC 스크립트는 다시 쓰는 횟수와 관계없이 실행마다 고정 가격을 청구합니다. 편집기는 실행이 시작되기 전에 실행 버튼에 가격을 표시합니다.

• 세 번 시도해도 규칙을 맞추지 못한 실행은 환불됩니다. “스크립트가 세 번 시도한 뒤에도 동영상 규칙을 충족하지 못했습니다:”라는 메시지와 함께 아직 남은 문제가 표시되며 실패합니다.
• 다른 이유로 실패한 실행도 환불됩니다.
• 유지한 스크립트는 비용 없이 전달됩니다. 그 뒤의 클립은 유지한 스크립트의 길이와 스크린샷 카드 기준으로 가격이 매겨집니다.

동영상 전체 가격은 편집기의 가격을 참고하세요.

팁

• 스크린샷은 말하는 순서대로 업로드하세요. 카드 순서는 스크린샷 입력의 순서입니다.
• 마음에 드는 스크립트는 유지하세요. 이 스크립트 유지를 켜거나 줄을 편집하고 저장하세요. 그러면 다음에 워크플로 전체를 실행할 때 새 스크립트 비용을 내지 않고 스크립트를 그대로 전달합니다.
• 카드를 넣으려면 스크린샷을 3~8장 사용하세요. 그보다 적으면 동영상에 카드가 없습니다.
• 게시할 때 스크립트는 비워집니다. 이번 실행 결과 포함으로 게시한 템플릿은 복사한 사람이 첫 스크립트를 쓸 때까지 말하는 줄을 예시로 보여 줍니다.

문제 해결

API에서 사용

UGC 스크립트는 실행될 때 POST /v1/ugc/script를 호출하며, 이 경로는 작업 ID로 응답합니다. UGC 경로의 요청과 응답 형식은 노드에 속하며 버전에 따라 바뀔 수 있습니다. 코드로 UGC 동영상을 만들려면 UGC 노드가 들어 있는 워크플로나 게시된 앱을 실행하세요.

실행 요청으로 UGC 스크립트의 targetDurationSec를 4~300 사이로 설정할 수 있습니다. UGC 노드에서 실행이 그 밖에 설정할 수 있는 것은 UGC 크리에이터의 source, gender, photoUrl뿐입니다. UGC 노드의 다른 필드를 설정하면 400 locked_field로 응답합니다. 워크플로와 미니앱을 참고하세요.

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