Nodaro 문서유틸리티, 레시피, 스킬
ping으로 연결을 확인하고, get_recipe로 검증된 레시피를 불러오고, 영화 디렉터 스킬을 시작하고, 빌더 도구로 UGC 웹사이트 동영상을 준비하세요.
유틸리티, 레시피, 스킬 도구는 어시스턴트가 작업을 제대로 시작하도록 돕습니다. ping은 연결을 확인하고, get_recipe는 검증된 여러 단계 플레이북을 불러오고, start_film_director는 영화 디렉터 스킬을 불러오며, UGC 빌더 세 가지는 웹사이트를 소개하는 크리에이터 동영상을 준비합니다. 이 도구들은 미디어를 생성하지 않고 크레딧도 쓰지 않습니다. 이 페이지의 다른 세 도구는 크레딧을 씁니다. capture_site는 웹 페이지를 스크린샷으로 캡처하고, ugc_split_speech와 ugc_finish_clips는 UGC 동영상의 음성을 자르고 클립을 마무리합니다.
지침을 반환하는 다른 도구는 각 도구 그룹에서 설명합니다. start_workflow_editor와 get_node_skill, start_video_director, get_studio_production_skill, get_recast_authoring_skill입니다.
ping
pong, 내 Nodaro 사용자 ID, 이 도구를 호출한 클라이언트의 이름을 반환합니다. 커넥터가 작동하는지 확인할 때 사용하세요.
권한: 없음, 항상 표시됨. 크레딧: 무료.
이 도구에는 매개변수가 없습니다.
get_recipe
콘텐츠 레시피를 나열하고 불러옵니다. 콘텐츠 레시피는 내레이션이 있는 애니메이션 설명 동영상처럼, 여러 도구를 쓰는 전체 흐름을 어시스턴트에게 단계별로 안내하는 검증된 플레이북입니다. 이 도구는 텍스트만 반환합니다. 레시피가 요구하는 작업은 다른 도구로 하며, 각 도구에는 자체 권한과 가격이 있습니다. 레시피 목록은 콘텐츠 레시피를 참고하세요.
권한: 없음, 항상 표시됨. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
recipe | string | video-explainer 같은 레시피 이름입니다. 생략하면 모든 레시피를 나열합니다. |
file | string | references/prompts.md처럼 레시피 안에 있는 레퍼런스 파일입니다. recipe가 필요합니다. |
반환값: 인수가 없으면 각 레시피의 이름, 설명, 트리거 문구를 반환합니다. recipe를 주면 레시피의 전체 지침을, file을 주면 그 파일을 반환합니다. 알 수 없는 이름이면 유효한 이름과 함께 오류를 반환합니다.
Nodaro Cloud에서는 목록에 UGC 웹사이트 동영상도 들어 있습니다. 크리에이터가 카메라를 보며 사이트를 소개하고, 사이트의 스크린샷이 카드로 표시되는 동영상입니다.
start_film_director
영화 디렉터 스킬을 반환합니다. 이 스킬은 어시스턴트가 스크립트부터 최종 편집본까지 10단계로 영화를 연출하면서, 내 캔버스에 편집 가능한 워크플로를 만들어 가게 하는 지침입니다. 어시스턴트는 예고편, 단편 영화, 뮤직비디오, 릴스, 광고처럼 여러 샷으로 된 동영상 요청이 오면 이 도구를 가장 먼저 호출합니다. 영화 디렉터를 참고하세요.
권한: 없음, 항상 표시됨. 크레딧: 무료. Nodaro Cloud 전용.
이 도구에는 매개변수가 없습니다. 아무것도 변경하지 않습니다.
capture_site
웹 페이지를 실제 휴대폰 너비의 스크린샷으로 캡처합니다. 페이지 전체 이미지 한 장과, 휴대폰 카드 형태로 자른 섹션 스틸을 최대 8장 반환합니다. 각 섹션의 제목, 위치, 짧은 텍스트가 담긴 페이지 섹션 맵과, 페이지 텍스트에 있는 정확한 수치도 반환합니다. 동의 팝업은 숨기며, 절대 수락하지 않습니다.
권한: workflows:execute. 크레딧: 캡처마다 정해진 가격입니다. 이 도구는 설치에서 페이지 캡처를 켠 경우에만 나열됩니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
url | string | 필수. 캡처할 페이지입니다. https://는 생략해도 됩니다. 최대 2,048자입니다. |
max_stills | integer | 반환할 섹션 스틸의 최대 개수로, 3~8입니다. 기본값은 8입니다. |
client_request_id | string | 재시도 토큰으로, 문자, 숫자, _ - . :로 된 8~128자입니다. 타임아웃 후 재시도할 때 다시 사용하면 캡처가 두 번 시작되거나 두 번 청구되지 않습니다. |
반환값: 작업 ID입니다. 스틸은 wait_for_job의 outputData.stills에서 읽으며, 각각 assetId와 url이 있습니다. 스틸은 내 미디어에 저장되고, 내가 저장하기 전까지 선택기에는 표시되지 않으며, 내 저장 공간을 사용합니다.
자동 방문자를 차단하거나 빈 페이지로 돌아오는 페이지는 실패하고 크레딧이 환불됩니다. robots.txt가 캡처를 허용하지 않는 페이지는 아무것도 실행하기 전에 거부됩니다.
UGC 동영상 빌더
UGC 웹사이트 레시피가 쓰는 무료 도구 세 가지입니다. 아무것도 생성하지 않으며, 각 도구는 자기 부분을 검사하거나 준비한 뒤 다음 생성 호출에 쓸 정확한 인수를 반환합니다. 다른 두 도구인 ugc_split_speech와 ugc_finish_clips는 같은 레시피의 오디오와 동영상 작업을 호출마다 정해진 가격으로 처리합니다. 다섯 도구 모두 Nodaro Cloud에서만 사용할 수 있고 권한이 필요하지 않습니다. 단, 저장된 캐릭터로 build_ugc_creator를 쓸 때는 assets:read가 필요합니다.
build_ugc_creator
카메라를 보며 말하는 크리에이터를 준비합니다. 새로 샘플링한 인물, 저장된 내 캐릭터, 내 사진 중 하나를 씁니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
source | string | 필수. sampled, character, photo 중 하나입니다. |
character_id | string | character일 때 쓰는 저장된 캐릭터입니다. |
photo_url | string | photo일 때 쓰는 내 사진입니다. |
gender | string | woman 또는 man입니다. |
product_category, overrides, previous, seed | 샘플링한 크리에이터를 조정하거나 똑같이 다시 만들 때 쓰는 선택 항목입니다. |
반환값: 크리에이터의 정체성 이미지, 또는 다음에 실행할 이미지 생성의 정확한 인수입니다. 샘플링한 크리에이터라면 후보마다 이미지 한 장이므로, 사용자가 그중 하나를 고를 수 있습니다.
build_ugc_clips
(Nodaro Cloud 전용) UGC 동영상 스크립트를 검사하고(모든 문제를 한 번에, 각각의 해결 방법과 함께), 클립마다 하나의 generate_video 호출, 클립을 잇는 호출, 동영상 나머지 부분의 크레딧 견적을 반환합니다. 스크립트는 영어나 히브리어로 쓸 수 있습니다. 히브리어 스크립트에는 두 단계로 답합니다. 첫 호출은 녹음할 음성과 그 음성을 나누는 방법을 견적과 함께 반환합니다. ugc_split_speech의 segments를 넣어 다시 호출하면 세그먼트마다 하나의 generate_video 호출을 받습니다. 권한이 필요 없고 무료입니다. UGC 웹사이트 레시피(get_recipe)에서 씁니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
plan | object | 필수. 스크립트입니다. |
gender | string | 필수. woman 또는 man입니다. |
identity_images | array | 필수. 크리에이터 이미지 1~2장입니다. |
traits, seed | 선택 항목입니다. | |
spent_job_ids | array | 이 동영상을 위해 이미 실행한 작업으로, 견적에 사용한 작업으로 표시됩니다. 최대 64개입니다. |
segments | array | ugc_split_speech의 출력에 있는 구간으로, 첫 호출의 응답이 요청했을 때 넣습니다. 첫 호출에서는 생략하세요. 최대 8개입니다. |
speech_lane | string | 영어 전용입니다. reference-audio(기본값): 보이스가 스크립트를 말하고 동영상 모델이 그 연기를 합니다. prompt-quoted: 동영상 모델이 자체 목소리로 대사를 읽습니다. |
voice_id | string | 영어 전용입니다. reference-audio 방식의 보이스로, 프리메이드 이름이나 list_voices의 ID입니다. 빌더가 크리에이터에 맞춰 고르는 보이스 대신 쓰입니다. |
반환값: 클립마다 바로 실행할 수 있는 generate_video 호출 하나, 클립을 이어 붙이는 호출, 남은 동영상 작업의 크레딧 견적입니다.
build_ugc_cards
UGC 동영상의 단어 타이밍을 바탕으로 스크린샷 카드와 자막의 타이밍을 맞춥니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
plan | object | 필수. 스크립트입니다. |
alignment 또는 words | array | forced_alignment나 transcribe에서 받은 단어 타이밍입니다. |
video_duration_ms | number | 동영상의 길이입니다. |
caption_style | string | 첫 줄 다음 자막의 모양입니다. body-captions(단어 단위, 기본값), karaoke, clean-subtitles, none 중 하나입니다. 첫 줄은 항상 배경판을 유지합니다. |
반환값: overlay_images에 쓸 레이어와 add_captions에 쓸 자막 구간입니다.
ugc_split_speech
UGC 동영상의 녹음된 음성을 말이 멈추는 지점마다 구간으로 자릅니다. 각 구간은 양쪽에 짧은 무음을 둔 오디오 파일로 저장됩니다.
크레딧: 호출마다 정해진 가격입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
plan | object | 필수. 스크립트입니다. |
audio_url 또는 audio_asset_id | string | 음성으로, URL이나 Nodaro 작업 또는 업로드 ID입니다. |
alignment | array | 필수. 음성의 단어 타이밍으로, { word, start, end } 항목 1~2,000개입니다. |
반환값: 구간 목록이 출력에 담긴 작업으로, build_ugc_clips의 segments 매개변수에 씁니다.
ugc_finish_clips
렌더링된 각 클립을 그 클립에 주어진 오디오와 대조하고, 원래 오디오를 클립에 입히고, 단어 사이의 빈 구간을 잘라 낸 뒤, 완성된 클립을 순서대로 반환합니다. 클립이 오디오와 맞지 않으면 다시 렌더링할 클립을 알려 주고 아무것도 바꾸지 않습니다.
크레딧: 호출마다 정해진 가격입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
segments | array | 필수. ugc_split_speech에서 받은 구간으로, 1~8개입니다. |
clips | array | 필수. 항목 1clip(1video_url 또는 video_asset_id로 지정한 렌더링된 동영상이 있습니다. reroll_video_url 또는 reroll_video_asset_id는 다시 렌더링한 클립입니다. |
구간으로 만든 히브리어 동영상에서는 각 클립에 그 배경의 소리도 입힙니다. 배경에 맞춘 리버브, -16 LUFS 레벨, 그 아래에 깔리는 룸 톤입니다. 야외, 자동차, 홀 배경은 리버브와 레벨만 적용되고 룸 톤은 없습니다. 이 단계가 실패하면 클립은 이 처리 없이 경고와 함께 반환됩니다.
반환값: 완성된 클립 목록이 순서대로 출력에 담긴 작업입니다.
자주 묻는 질문
어시스턴트가 Nodaro에 연결되었는지 어떻게 확인하나요?
어시스턴트에게 ping을 호출해 달라고 요청하세요. 이 도구는 pong, 내 Nodaro 사용자 ID, 클라이언트 이름으로 응답하며, 권한이 필요하지 않습니다.
get_recipe는 무엇을 반환하나요?
미디어가 아니라 지침을 반환합니다. 인수 없이 호출하면 레시피를 설명, 트리거 문구와 함께 나열하고, 레시피 이름을 주면 그 레시피의 전체 플레이북을 반환합니다. 어시스턴트는 그 플레이북에 따라 다른 도구를 사용합니다.
UGC 빌더 도구가 동영상을 생성하나요?
아니요. 빌더 세 가지는 UGC 웹사이트 레시피를 돕는 무료 도구입니다. 크리에이터를 준비하고, 스크립트를 검사하고, 카드와 자막의 타이밍을 맞춘 다음, 다음에 할 정확한 호출을 크레딧 견적과 함께 반환합니다. 다른 두 도구인 ugc_split_speech와 ugc_finish_clips는 호출마다 정해진 가격으로 음성을 자르고 클립을 마무리합니다.
관련 문서
콘텐츠 레시피
영화 디렉터
MCP 도구 레퍼런스
문제 해결
최종 업데이트