Nodaro 문서Recast
JSON으로 쓴 영화 스크립트를 렌더링된 Recast 프로젝트로 바꾸는 Recast 도구 여섯 개의 매개변수입니다. 무료 검증, 견적, 캐스팅도 다룹니다.
Nodaro Cloud에서 사용할 수 있습니다
Recast 도구는 JSON 스크립트 하나로 쓴 영화를 Nodaro에서 렌더링되고 recast.nodaro.ai에서 열리는 실제 Recast 프로젝트로 바꿉니다. 이 페이지에는 각 도구의 매개변수가 나와 있습니다. 진행 흐름과 스크립트 형식은 Recast에서 설명하므로 먼저 읽어 보세요.
Recast 도구는 Nodaro Cloud에만 있습니다.
| 도구 | 권한 | 크레딧 |
|---|---|---|
get_recast_authoring_skill | 없음 | 무료 |
validate_recast_script | 없음 | 무료 |
import_recast_script | workflows:write | 무료 |
start_recast | workflows:execute | 견적 가격, confirm: true일 때만 |
resolve_recast_gate | workflows:execute | 무료 |
get_recast_status | workflows:read | 무료 |
get_recast_authoring_skill
JSON으로 쓰는 영화의 작성 가이드를 반환합니다. 문서 형식(meta, slots, scenes), 각 필드의 의미, 허용되는 값, 한도, 오디오 규칙, 검증된 실제 예시가 담깁니다. 가이드는 플랫폼이 직접 사용하는 플래너로 생성됩니다.
이 도구에는 매개변수가 없습니다.
validate_recast_script
직접 쓴 스크립트를 무료로, 필요한 만큼 몇 번이든 확인합니다. 비용을 청구하지 않으며 아무것도 저장하지 않습니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
script | object | 필수. 직접 쓴 스크립트 또는 내보낸 분석 전체입니다. |
반환값: valid, errors, warnings입니다. 각 오류에는 path, message, 그리고 대개 hint가 있습니다. 오류를 하나씩 고치고, valid가 true가 될 때까지 다시 호출하세요.
import_recast_script
검증된 스크립트를 Recast 프로젝트로 바꿉니다. 프로젝트와 워크플로를 만들고, 스크립트를 완료된 분석으로 저장합니다. 가져오기는 무료입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
script | object | 필수. 검증된 스크립트입니다. |
rights_attested | boolean | 필수이며, true만 됩니다. 사용자가 대화에서 스크립트가 자신의 작품이거나 자신에게 권리가 있다고 확인한 뒤에만 설정하세요. |
반환값: recastId, jobId, warnings, 그리고 프로젝트 링크인 appUrl입니다.
start_recast
가져온 Recast의 견적을 내고 렌더링합니다. confirm이 없으면 가격만 반환합니다. 사용자가 그 가격을 수락한 뒤 confirm: true로 호출하면 계획과 렌더링을 구매합니다. 실행이 진행 중일 때 다시 호출하면, planned 상태의 실행을 새 청구 없이 렌더링으로 넘기거나 진행 상황을 알려 줍니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
recast_id | string | 필수. import_recast_script에서 받은 recastId입니다. |
confirm | boolean | 사용자가 견적 크레딧을 수락한 뒤에만 true입니다. |
interactive | boolean | 렌더링 전에 사용자가 출연진을 고를 수 있게 합니다. 요소마다 후보 3개와 세 후보 중 하나를 고르는 게이트가 있습니다. 견적에 추가 요금이 붙으므로 확정하기 전에 물어보세요. |
resolution | string | 출력 해상도입니다. 기본값은 720p입니다. |
segment_pack | string | 장면을 파트로 묶는 방식입니다. scenes-max(기본값, 이음매가 가장 적고 가장 저렴함) 또는 scenes(더 짧은 파트)입니다. |
anchor_mode | string | 파트를 잇는 방식입니다. progressive(각 파트의 시작 프레임이 이전 렌더링에서 이어짐) 또는 none(프레임 조건 없음, 견적에서 시작 프레임 추가 요금이 빠짐)입니다. 서버 기본값을 쓰려면 생략하세요. |
provider | string | 동영상 모델을 직접 지정합니다. 서버 기본값을 쓰려면 생략하세요. |
반환값: 견적 또는 실행 상태입니다.
resolve_recast_gate
대화형 게이트에서 사용자의 선택을 기록하고 실행을 이어 갑니다. 선택 자체는 무료입니다. 추가 요금은 start_recast에서 이미 수락했습니다. 옵션은 get_recast_status가 보여 주는 후보에 대한 0부터 시작하는 인덱스입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
recast_id | string | 필수. 대상 Recast입니다. |
picks | object | 출연진 게이트나 정체성 시트 게이트: 슬롯 ID마다 선택한 후보 인덱스를 대응시킵니다. |
gate | string | picks가 답하는 게이트로, cast(기본값) 또는 sheet입니다. |
segment, anchor_start, anchor_end | integer | 장면 스틸 게이트: 장면과, 선택한 시작 프레임과 종료 프레임입니다. |
section, music_pick | integer | 음악 게이트: 음악 구간과 선택한 테이크입니다. |
finish_auto | boolean | 이 게이트와 남은 모든 게이트를 자동 평가 AI의 최상위 후보로 결정해, 실행이 스스로 끝나게 합니다. |
게이트는 출연진, 사람의 정체성 시트, 장면 스틸, 음악 순서로 열립니다. 시트 게이트에서는 세 시트가 출연진 게이트에서 고른 얼굴을 공유하므로, 몸과 옷만 고르면 됩니다.
get_recast_status
Recast의 진행 상황을 반환합니다. 상태는 blueprint ready(청사진 준비 완료), planning(계획 중), planned(계획 완료), generating(생성 중), completed(완료), failed(실패) 중 하나입니다. generating에는 전체 세그먼트 중 완료된 수와 실시간 미리 보기가, completed에는 결과 URL이 담깁니다. recast.nodaro.ai의 프로젝트 링크가 항상 포함됩니다. MCP Apps를 표시하는 클라이언트에서는 진행률 표시줄, 점점 길어지는 미리 보기, 게이트 후보 버튼이 있는 실시간 카드를 보여 줍니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
recast_id | string | 필수. 대상 Recast입니다. |
상태가 planned이면 start_recast를 다시 호출해 렌더링을 시작하세요.
자주 묻는 질문
Recast 스크립트를 검증하거나 가져오는 데 크레딧이 드나요?
아니요. validate_recast_script와 import_recast_script는 무료입니다. 크레딧은 사용자가 견적 가격을 수락한 뒤 confirm을 true로 설정해 start_recast를 호출할 때만 사용됩니다.
rights_attested는 무슨 뜻인가요?
사용자가 대화에서 스크립트가 자신의 작품이거나 자신에게 권리가 있다고 확인했음을 기록합니다. 직접 쓴 Recast는 브랜드 이름까지 포함해 쓴 그대로 렌더링되므로, 어시스턴트는 묻지 않고 이 값을 설정해서는 절대 안 됩니다.
렌더링 전에 사용자가 출연진을 고를 수 있나요?
네. interactive를 true로 설정해 실행을 시작하세요. 출연진, 정체성 시트, 장면 스틸, 음악에서 세 후보 중 하나를 고르는 게이트마다 실행이 멈춥니다. 대화형 모드에는 견적에 포함되는 추가 요금이 붙습니다.
사용자는 Recast를 어디에서 보고 편집할 수 있나요?
recast.nodaro.ai에서 할 수 있습니다. get_recast_status는 항상 프로젝트로 바로 가는 링크를 반환하며, 사용자는 그곳에서 다시 캐스팅하고, 다시 촬영하고, 대화형 선택을 할 수 있습니다.
관련 문서
Recast
Recast
스튜디오 프로덕션
분석과 편집 목록
최종 업데이트