스튜디오 프로덕션

스튜디오 프로덕션 도구는 studio.nodaro.ai의 Nodaro Studio 편집기에서 열리는 영화를 만들고 변경합니다. 이 페이지에는 각 도구의 매개변수가 나와 있습니다. 작업 루프, 사용자와 대화할 때 쓰는 용어, 편집 오퍼레이션, 크레딧 사용 규칙은 스튜디오 프로덕션에서 설명합니다. 먼저 읽어 보세요.

스튜디오 프로덕션은 Nodaro Cloud 기능입니다. 이 기능이 없는 배포에서는 이 그룹의 모든 도구가 not_available로 응답합니다. 기능을 제안하기 전에 list_studio_productions를 호출해 확인하세요.

도구, 권한, 가격

크레딧을 쓰는 도구와, 작업물을 볼 수 있는 사람을 바꾸는 share_studio_production에는 도구 정의에 확인 표시가 붙어 있습니다. 크레딧을 쓰는 도구는 8~128자의 재시도 토큰인 client_request_id를 받습니다. 시간 초과 후 같은 값을 다시 보내면 어떤 작업도 두 번 시작되거나 두 번 청구되지 않습니다.

계획과 읽기

get_studio_production_skill

어시스턴트가 프로덕션 작업을 시작하기 전에 읽는 가이드를 반환합니다. 가이드는 실제로 운영 중인 배포에서 생성됩니다.

validate_studio_plan

작성한 플랜을 무료로 검사하며, 아무것도 저장하지 않습니다. 또한 모든 cast 이름을 내 캐릭터, 장소, 오브젝트, 크리처와 대조합니다.

반환값: valid, errors(각 오류에 해당 필드 이름 포함), warnings, 그리고 출연진 이름 중 몇 개가 내 라이브러리와 일치했는지 알려 주는 summary입니다. 오류를 고치고 valid가 true가 될 때까지 다시 호출하세요.

list_studio_productions

내 프로덕션을 최신순으로 나열합니다. ID, 이름, 버전, 썸네일, 공유 여부, 장면 수를 반환합니다. 대시보드와 마찬가지로 보관된 프로덕션은 표시되지 않습니다.

get_studio_production

프로덕션 하나를 반환합니다. 영화 룩, 출연진, 폴더, 컷, 휴지통, 실행 중인 항목, 그리고 타임라인 순서의 장면이 들어 있습니다. workflows:write 권한이 있으면 마지막으로 읽은 뒤 완료된 모든 작업을 먼저 반영하므로, 완료된 생성은 이 읽기를 통해 장면에 들어갑니다.

반환값: 프로덕션과, 아직 실행 중인 항목을 알려 주는 pending 블록입니다. 결과는 위치가 아니라 key, 작업 ID 또는 URL로 지정하세요.

plan_studio_export

프로덕션을 내보내는 단계를 순서대로, 크레딧 견적과 함께 반환합니다. 아무것도 시작하지 않고 아무것도 청구하지 않습니다. 사용자가 수락하기 전에 보여 주세요.

만들기와 변경

create_studio_production

내 Studio 프로젝트에 프로덕션을 만듭니다. 만든 프로덕션은 studio.nodaro.ai의 내 대시보드에 바로 나타납니다. 플랜을 함께 보내면 모든 장면, 출연진 연결, 영화 룩이 같이 들어가고, 플랜이 없으면 빈 프로덕션이 만들어집니다. 먼저 플랜을 검증하세요.

import_studio_production

기존 프로덕션에 플랜의 장면을 추가하고, 새 출연진을 등록합니다. 프로덕션의 이름, 개요, 룩은 바꾸지 않습니다.

edit_studio_production

오퍼레이션 일괄 처리로 프로덕션을 변경합니다. 장면 이름 바꾸기, 타임라인 순서 바꾸기, 테이크 선택, 장면 모션 안의 샷 설정, 출연진 등록, 휴지통 비우기 같은 오퍼레이션이 있습니다. 오퍼레이션과 그 인수는 get_studio_production_skill이 part: "operating"으로 제공합니다.

반환값: receipts입니다. 오퍼레이션마다 과거형으로 쓴 한 줄이 들어 있습니다. 일괄 처리는 한 단계로 적용됩니다. 오퍼레이션 하나가 거부되면 응답에 그 인덱스가 표시되고 아무것도 쓰이지 않습니다. 조금 이전 버전을 기준으로 작성한 일괄 처리도 적용되며, 이때 rebased: true가 표시됩니다.

share_studio_production

프로덕션을 공유 링크로 공개하거나 다시 비공개로 돌립니다. 링크가 있는 사람은 누구나 공유된 프로덕션을 읽을 수 있으므로 먼저 사용자에게 물어보세요. 공유 상태는 이 도구로만 바뀝니다.

clone_studio_production

내 프로덕션이나 나와 공유된 프로덕션을 내 Studio 프로젝트로 복사합니다. 사본은 비공개로 시작하며, 그래프와 반영된 모든 결과를 함께 가져갑니다. 위험한 편집을 한 차례 하기 전에 사용하세요.

생성

생성은 작업 ID를 바로 반환합니다. 완료된 결과는 다음 get_studio_production 호출에서야 장면에 들어갑니다. get_job과 wait_for_job은 상태를 알려 줄 뿐 결과를 반영하지 않습니다.

describe_studio_production

개요를 디렉터에게 넘기면 디렉터가 장면, 출연진, 룩을 프로덕션에 써 넣습니다. 사용자에게 플랜이 아니라 이야기가 있을 때 사용하세요.

generate_studio_still

장면에 이미 있는 내용, 즉 프롬프트, 레퍼런스, 출연진, 연출을 바탕으로 장면 프레임의 후보를 생성합니다. 다시 생성하면 테이크가 추가되며, 기존 테이크를 대체하지 않습니다.

generate_studio_keyframe

계획된 프레임의 후보 하나를 생성합니다. 계획된 프레임은 사용자가 검토하고 수락하는 프레임으로, 장면의 프레임과는 다릅니다. 파생 프레임에는 수락된 부모 프레임이 필요합니다. 이 도구에는 견적이 없으며, dry_run: true는 거부됩니다.

후보가 반영되어도 수락되지 않으며, 다른 프레임이 시작되지도 않습니다. 검토한 뒤 edit_studio_production으로 수락하세요. 이 도구는 계획된 프레임을 지원하는 배포에서만 쓸 수 있습니다.

generate_studio_clip

장면의 프레임, 시작 프레임과 종료 프레임, 연출을 바탕으로 장면의 모션을 생성합니다.

연결된 테이크를 그대로 리테이크하려면 먼저 retake_result_key와 dry_run: true로 호출하고 가격과 inputHash를 확인하세요. 그런 다음 dry_run 없이 expected_input_hash와 새 client_request_id를 붙여 같은 호출을 제출하세요. 리테이크는 그 뒤로 플랜이 바뀌었더라도 테이크의 원래 설정과 시작·종료 프레임 이미지를 사용합니다. 이 기능을 지원하는 배포는 operations.retakeLinkedClips 기능을 알립니다.

new_studio_shot_from_frame

장면의 현재 모션에서 프레임 하나를 가져와 활용합니다. 호출은 추출이 끝날 때까지 기다린 뒤 업데이트된 프로덕션으로 응답합니다.

voice_studio_shot

장면 위에 대사 한 줄을 보이스오버로 입힙니다. 호출은 음성이 완성될 때까지 기다린 뒤 업데이트된 프로덕션으로 응답합니다.

revoice_studio_clip

장면의 현재 모션 안에 있는 보이스를 교체합니다. 대사를 다시 연기해 같은 화면 위에 다시 믹스합니다.

score_studio_production

음악 설명으로 프로덕션 전체에 쓸 사운드트랙 하나를 만듭니다.