스튜디오 프로덕션

스튜디오 프로덕션은 AI 어시스턴트가 대화로 연출하고, 내가 studio.nodaro.ai의 스튜디오 편집기에서 계속 편집하는 영화입니다. 프로덕션은 순서가 정해진 장면 목록이며, 각 장면에는 프레임, 선택 사항인 모션, 그리고 이를 만든 플랜, 룩, 출연진, 보이스가 있습니다. 어시스턴트는 영화의 초안을 만들어 넘겨주고, 내가 장면 세 개를 옮긴 뒤에도 다시 이어서 작업할 수 있습니다. 스튜디오 프로덕션은 Nodaro Cloud 기능입니다.

“영화, 장면, 시퀀스를 만들어 주고 내가 계속 편집할 수 있게 해 주세요” 같은 요청에는 이 방식을 선택하세요. JSON 문서 하나로 쓴 영화는 Recast를, 캔버스의 워크플로는 영화 디렉터를 참고하세요.

두 가지 용어

편집기와 프로덕션 문서는 같은 것을 서로 다르게 부릅니다. 사용자는 편집기만 보므로, 어시스턴트는 편집기의 용어로 말하고 문서의 이름은 도구 호출에만 씁니다.

• “장면 N”은 항상 shots[]의 N번째 항목입니다. “장면 3 이름 바꾸기”는 그 항목에 대한 rename_shot이고, “장면 3 삭제”는 그 항목에 대한 remove_shot입니다.
• “샷”은 모션 안의 샷을 뜻합니다. 사용자가 보고 있는 장면의 beats[] 항목이며, 절대 shots[] 항목이 아닙니다. 보고 있는 장면이 없거나, 그 장면의 모션에 있는 샷이 사용자가 말한 수보다 적으면, 어시스턴트는 추측하지 않고 물어봅니다.
• 장면의 프레임은 그 장면의 still입니다. 계획된 프레임은 다른 것입니다. generate_studio_keyframe으로 만들며, 사용자가 검토하고 수락하는 프레임 계획입니다. 장면의 시작 프레임과 종료 프레임은 그 장면 모션의 양 끝입니다.
• 영수증은 문서의 용어를 씁니다. 오퍼레이션 이름과 편집의 receipts는 장면을 뜻할 때 “샷”이라고 하므로, 어시스턴트는 그 표현을 사용자에게 그대로 반복하면 안 됩니다.

작업 순서

대화가 중단되어도 버려지는 것은 없습니다. 프로덕션은 편집기에서 열 수 있는 실제 영화이며, 아직 실행 중이던 생성은 다음에 내가, 편집기가, 또는 다음 어시스턴트가 프로덕션을 최신 상태로 만들 때 반영됩니다.

오퍼레이션을 사용한 편집

프로덕션의 모든 변경은 오퍼레이션이며, 오퍼레이션을 적용하는 도구는 edit_studio_production 하나뿐입니다. 일괄 처리는 문서의 최신 버전에 한 단계로 적용됩니다.

• 오퍼레이션은 변하지 않는 키로 대상을 지정합니다. 장면은 ID로, 출연진 멤버는 역할 슬러그로, 결과는 작업 ID나 URL로 지정합니다. 사용자가 브라우저에서 같은 영화를 편집하고 있을 수 있으므로, 절대 위치로 지정하지 않습니다.
• 조금 오래된 버전을 기준으로 작성한 일괄 처리도 적용되며, 응답에 리베이스되었다고 표시됩니다. expected_version과 함께 strict: true를 보내면 대신 거부합니다.
• 오퍼레이션 하나가 잘못되면 일괄 처리 전체가 거부되며 아무것도 쓰지 않습니다. 오류는 0부터 센 인덱스로 해당 오퍼레이션을 알려 주므로, 고친 다음 일괄 처리를 다시 보내세요.
• receipts에는 오퍼레이션마다 과거형 문장이 한 줄씩 있습니다. 방금 무슨 일이 있었는지 묻는 사용자에게 보여 줄 내용입니다.
• 일부 삭제는 되돌릴 수 있습니다. 제거한 장면, 테이크, 계획된 프레임은 프로덕션의 휴지통으로 이동하며 복원할 수 있습니다. 출연진 멤버, 보이스, 사운드트랙 지우기, 컷 삭제, 시퀀스 제거, 휴지통 항목 영구 삭제, 휴지통 비우기는 되돌릴 수 없습니다.
• 공유는 오퍼레이션이 아닙니다. 공유에는 별도의 도구가 있으므로, 편집 일괄 처리로 작업물을 볼 수 있는 사람이 바뀌는 일은 없습니다.
• 프로덕션 삭제는 지원되지 않습니다. 보관은 오퍼레이션이며 되돌릴 수 있습니다.

오퍼레이션 어휘는 여기에 싣지 않고 서버가 제공합니다. part: "operating"으로 get_studio_production_skill을 호출하면 배포 환경이 받는 오퍼레이션이 반환됩니다.

일괄 처리 미리 보기

dry_run: true로 edit_studio_production을 호출하면 일괄 처리가 무엇을 할지 알려 주고 아무것도 쓰지 않습니다. 각 오퍼레이션의 영수증에는 분류가 붙습니다. S는 문서를 변경하고, D는 삭제하고, P는 작업물에 접근할 수 있는 사람을 바꾸고, $는 크레딧을 씁니다. 휴지통으로 갈 삭제에는 restorable: true가 표시됩니다. 미리 보기를 사용자에게 보여 준 다음, 같은 일괄 처리를 dry_run 없이 보내세요.

이 도구는 먼저 배포 환경이 미리 보기를 지원하는지 확인하고, 지원하지 않으면 아무것도 보내지 않은 채 studio_preview_unavailable로 거부합니다. 미리 보기의 ID는 실제 변경의 ID가 아닙니다. 되돌리려면 적용된 일괄 처리의 영수증에서 휴지통 ID를 읽으세요.

크레딧 사용

영화를 연출하는 어시스턴트는 수십 번 호출하므로, 두 가지 습관이 중요합니다.

• 먼저 견적을 받으세요. generate_studio_still과 generate_studio_clip은 dry_run: true를 받으며, 이때 모델과 가격을 반환하고 아무것도 쓰지 않습니다. credits: null은 무료가 아니라 가격을 알 수 없다는 뜻입니다. 가격을 보여 주고 사용자가 수락하게 하세요. 다른 지출 도구에는 견적이 없으므로, 모델로 가격을 계산하거나 먼저 물어보세요.
• 안전하게 재시도하세요. 모든 지출 도구는 A-Za-z0-9_.:- 문자로 된 8~128자의 client_request_id를 받습니다. 같은 토큰을 보내면 첫 호출의 작업으로 응답하고 새로 청구하지 않습니다. 새 요청마다 새 토큰을 만들고, 토큰 없이 지출 호출을 재시도하지 마세요.

생성은 실행, 폴링, 반영 순서로 진행됩니다.

1. 프레임이나 모션 호출은 작업 ID를 즉시 반환합니다.
2. get_job으로 그 작업을 기다리거나, 프로덕션의 pending 블록을 지켜보세요.
3. get_studio_production으로 프로덕션을 다시 읽으세요. 쓰기 권한이 있으면 읽기가 응답하기 전에 완료된 모든 작업을 반영합니다.
4. 도착한 것을 사용자에게 보여 주세요.

읽기 전용 권한이면 읽기가 아무것도 반영하지 않으며, 완료된 작업은 쓰기 권한이 있는 사람이 프로덕션을 최신 상태로 만들 때까지 pending에 남아 있습니다.

확인 표시

크레딧을 쓰거나 작업물을 볼 수 있는 사람을 바꾸는 도구는 자체 정의의 _meta.nodaro.confirm에 그 사실을 표시합니다. 클라이언트는 자체 목록을 관리하는 대신, 이 표시가 있는 모든 도구 앞에 확인 프롬프트를 둘 수 있습니다.

edit_studio_production에는 표시가 없습니다. 일괄 처리가 하는 일은 그 안의 오퍼레이션에 따라 달라지기 때문입니다. 삭제 전에 확인하려면, 모든 오퍼레이션에 분류가 붙는 일괄 처리 미리 보기를 사용하세요.

권한

지출 도구 8개에는 workflows:write와 workflows:execute가 모두 필요합니다. 둘 중 하나만 허용한 연결에는 아무 설명 없이 이 도구가 하나도 보이지 않으므로, 생성하려면 둘 다 허용하세요. 읽기에는 workflows:read가, 만들기, 편집, 공유, 복제에는 workflows:write가 필요합니다. 도구 레퍼런스에 각 도구의 권한과 매개변수가 나와 있습니다.

사용 가능 여부

스튜디오 프로덕션을 제공하지 않는 배포 환경에서는 이 계열의 모든 도구가 not_available로 응답합니다. 재시도할 가치가 없는 단순한 거부입니다. 이 기능을 제안하기 전에 list_studio_productions를 호출해 확인하세요.

플랜 형식 문서

플랜 형식인 nodaro-studio-production의 공개 문서는 한 곳에만 있습니다. 스튜디오 앱은 같은 작성 가이드, 카탈로그, JSON Schema를 studio.nodaro.ai/skills/studio-production/에서 제공하므로, get_studio_production_skill을 읽는 어시스턴트와 그 페이지를 읽는 사람은 같은 문서를 읽습니다.

같은 프로덕션 방식은 REST의 스튜디오 프로덕션과 SDK의 client.studio.productions에서도 사용할 수 있습니다.