UGC 클립 목록

UGC 클립 목록 노드는 UGC 동영상 스크립트를 테이크마다 하나씩 클립으로 나눕니다. UGC 스크립트의 스크립트와 UGC 크리에이터의 크리에이터를 받아 스크립트를 다시 확인합니다. 각 클립은 UGC 클립으로 전달되어 렌더링됩니다.

동영상의 클립 개수는 길이와 줄에 따라 다릅니다. 노드에 클립과 각 클립의 길이가 표시됩니다. 노드만 따로 실행하면 클립과 이후 단계에 드는 비용도 표시됩니다.

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

사용 시기

• UGC 스크립트의 스크립트와 UGC 크리에이터의 크리에이터가 있고, 동영상을 렌더링하고 싶을 때.
• 클립을 렌더링하기 전에 클립 비용을 확인하고 싶을 때.
• 크리에이터가 말할 보이스를 고르고 싶을 때.

빠른 시작

입력

출력

클립만 여러 개로 나뉘어 전달됩니다. 나머지 두 출력은 연결 모드와 관계없이 값 하나를 전달합니다. 연결 모드를 참고하세요.

설정

스크립트 재확인

UGC 클립 목록은 스크립트가 동영상 규칙에 맞는지 다시 확인합니다. 스크립트가 규칙을 어길 수 있는 경우는 UGC 스크립트에서 줄을 편집했을 때뿐입니다. 그런 스크립트는 클립 비용을 지불하기 전에 UGC 클립 목록에서 “스크립트를 수정해야 합니다:”라는 메시지와 각 문제 및 해결 방법과 함께 실패합니다.

히브리어 스크립트

히브리어 스크립트는 먼저 선택한 음성으로 하나의 음성으로 녹음됩니다. 그 단어의 타이밍을 맞추고, 쉼이 있는 곳에서 나눕니다. 그런 다음 UGC 클립 목록이 나눈 조각마다 클립 하나를 전달하며, 각 클립은 최대 7초입니다. 이 세 단계에는 각각의 가격이 청구됩니다.

녹음은 동영상 길이의 최대 1.2배이며, 21초를 넘지 않습니다. 녹음이 더 길면 분할 단계에서 “SPEECH_TOO_LONG … 스크립트를 줄이세요.”와 함께 실행이 멈춥니다. 분할 비용은 환불됩니다. 음성과 단어 타이밍 비용은 그대로 청구됩니다. UGC 스크립트는 동영상 길이에 비해 너무 긴 히브리어 스크립트를 이미 다시 씁니다. 기준은 초당 2.5단어이며, 15초 동영상이면 45단어, 최대 52단어입니다.

히브리어 음성은 Maya와 Shira(여성), Itai와 Omer(남성)입니다.

히브리어 동영상의 클립을 하나라도 렌더링하기 전에, UGC 클립 목록은 분할 단계가 전달한 클립과 그 이후 단계의 가격을 매깁니다. 각 클립의 가격은 렌더링하는 동안 보류하는 금액입니다. UGC 클립 목록은 이 가격을 실행 시작 전에 잔액과 비교한 금액, 즉 그 동영상에서 허용되는 어떤 녹음이든 나뉠 수 있는 가장 많은 클립 수의 금액과 비교합니다. 클립이 더 많이 보류하게 되면 클립을 렌더링하기 전에 여기서 실행이 멈춥니다. 음성, 단어 타이밍, 분할 비용은 그대로 청구됩니다. 노드는 “이 녹음의 클립 비용이 이번 실행에서 확인한 금액을 넘어 클립을 하나도 렌더링하지 않았습니다. “UGC 클립 목록”을 다시 실행해 음성을 다시 녹음하세요.”라는 메시지와 함께 실패합니다. 이 확인 자체는 무료입니다.

히브리어 동영상에는 UGC 클립 뒤에 UGC 마무리가 있어야 하고, UGC 클립 목록의 스크립트(길이 조정됨) 출력을 거기에 연결해야 합니다. 없으면 UGC 클립 목록은 아무것도 쓰기 전에 ““UGC 클립” 뒤에 “UGC 마무리” 노드를 추가하고, “UGC 클립 목록”의 “스크립트(길이 조정됨)” 출력을 연결하세요.”라는 메시지와 함께 실패합니다.

클립 비용

UGC 클립 목록을 자체 실행 버튼으로 실행하면 노드에 클립 비용이 표시됩니다.

• 클립 줄: 클립마다 한 줄씩, 길이와 함께 표시됩니다.
• 단계 줄: 클립 이후 단계마다 한 줄씩 표시됩니다. 단계는 히브리어 동영상에서의 클립 마무리, 클립이 여러 개일 때의 클립 합치기, 단어 타이밍, 음성 확인, 스크린샷 카드가 있을 때의 스크린샷 카드, 자막입니다.
• 예상: 동영상에 들 것으로 예상되는 비용입니다.
• 클립 렌더링 중 보류: 클립을 렌더링하는 동안 실행이 보류하는 금액으로, 클립 가격의 약 2배입니다.

이렇게 UGC 노드를 하나씩 실행하면 클립을 렌더링하기 전에 금액을 볼 수 있습니다. 워크플로 전체를 실행하면 곧바로 클립으로 넘어가므로 UGC 클립 목록에 금액이 표시되지 않습니다. 이런 실행의 가격은 시작 전에 표시됩니다. 편집기의 가격을 참고하세요.

크레딧

UGC 클립 목록은 무료입니다. 노드에 표시되는 금액은 UGC 클립과 그 이후 단계에 드는 비용입니다. UGC 클립 크레딧을 참고하세요.

팁

• 가격을 먼저 확인하세요. UGC 스크립트, UGC 크리에이터, UGC 클립 목록을 각각의 실행 버튼으로 하나씩 실행하면 렌더링 전에 클립 비용을 볼 수 있습니다.
• 렌더링 전에 클립 길이를 확인하세요. 동영상이 길수록 클립이 많아집니다.
• 기본 연결 모드를 유지하세요. 클립이 개별 모드여야 UGC 클립이 클립마다 한 번 실행됩니다.

문제 해결

API에서 사용

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

POST /v1/ugc/quote는 UGC 동영상의 가격을 매깁니다. 무료이고, 아무것도 예약되지 않으며, 1분에 30번까지 호출할 수 있습니다. 두 가지 형식이 있습니다.

• 티켓: { "tickets": [ … ], "hasCards": true }는 UGC 클립 목록이 전달한 클립 1~11개의 가격을 UGC 클립과 그 이후 단계에서 실제로 드는 대로 매깁니다. UGC 클립 목록에 표시되는 금액이 이것입니다.
• 예상: { "estimate": { "targetDurationSec": 15, "screenshotCount": 3, "source": "sampled" } }는 아무것도 실행하기 전에 스크립트와 크리에이터를 포함한 동영상 전체의 가격을 매깁니다. targetDurationSec는 4300입니다. screenshotCount는 08이며, 1이나 2는 0으로 계산됩니다. source는 sampled(AI 크리에이터) 또는 photo입니다. 선택 항목인 rendersEveryCandidate는 편집기 실행처럼 모든 크리에이터 옵션을 만드는 경우의 가격을 매깁니다.

티켓 형식은 선택 필드 두 개를 받습니다.

• finishes: true는 히브리어 동영상처럼 클립이 UGC 마무리 작업을 거친다는 뜻입니다. 그러면 응답에 한 번 청구되는 “클립 마무리” 줄(키 finish)이 추가됩니다. 합치기 줄(키 join)은 템플릿의 합치기 노드가 청구되는 방식대로 가격이 매겨집니다. 즉 그 노드의 설정을 따르고, 각 클립은 동영상 합치기의 표준 길이인 8초로 계산됩니다. 클립이 클립 길이 없이 하나의 목록으로 도착하기 때문입니다.
• runEstimate는 클립이 속한 동영상의 예상 입력(targetDurationSec, screenshotCount, source, language)입니다. 그러면 응답에 runHold도 들어갑니다. 동영상의 예상이 클립과 그 이후 단계에 보류하는 최대 금액이며, 같은 hasCards와 finishes로 가격을 매깁니다.

두 형식 모두 lines(각각 영어 label, credits, 고정된 key 포함), expected, ceiling(클립을 렌더링하는 동안 동영상이 보류하는 금액), parts, holdParts로 응답합니다. 예상 형식은 길이의 0.8배와 1.2배에서의 예상 가격인 range와 worstCase도 응답합니다. 가격을 매길 수 없는 항목은 422 unpriceable로 응답합니다. UGC 경로가 제공되지 않는 곳에서는 503 not_available로 응답합니다.

히브리어 동영상(예상 형식의 language: "he")에서는 녹음된 음성이 클립 수를 정하므로, 예상에 0.8배와 1.2배 실행이 없습니다. expected와 ceiling은 음성에 필요할 것으로 예상되는 클립이며, range는 그런 음성에 보통 필요한 가장 많은 클립 수까지입니다. worstCase는 허용되는 어떤 녹음이든 나뉠 수 있는 가장 비싼 방식이며, 모든 클립을 가격의 2배로 계산합니다. 녹음은 목표 길이의 최대 1.2배이며 21초를 넘지 않습니다. 15초 동영상이면 18초이고, 17.5초 동영상부터는 21초입니다. 따라서 최악의 경우는 목표 길이에 따라 커지며, 최대 7초짜리 클립 6개까지입니다. 음성, 단어 타이밍, 분할, 마무리는 각각 별도의 줄이며, 각각 한 번 청구됩니다.

히브리어 동영상의 클립을 렌더링하기 전에, UGC 클립 목록은 runEstimate를 넣은 티켓 형식으로 분할 단계가 전달한 클립의 가격을 요청합니다. 편집기, 게시된 앱, API 실행 모두 같습니다. 그 ceiling이 runHold보다 크거나 금액을 얻을 수 없으면, 클립을 렌더링하기 전에 UGC 클립 목록에서 실행이 멈춥니다.