샷 시퀀스

샷 시퀀스는 화면의 모든 텍스트, 도형, 이미지가 보이스오버가 해당 구절을 말하는 순간에 나타나는, 내레이션이 있는 모션 그래픽 동영상입니다. 내가 직접, 또는 어시스턴트가 브리프를 씁니다. 브리프에는 내레이션과 그 큐, 그리고 장면, 샷, 리빌이 담깁니다. Nodaro는 녹음된 보이스오버를 단어 단위로 정렬하고 모든 큐를 정확한 프레임에 고정하므로, 타이밍이 매번 똑같이 정해집니다. 동영상 디렉터는 이 파이프라인을 기반으로 브리프를 대신 써 줍니다.

파이프라인

먼저 start_video_director를 호출하세요. 내레이션을 큐 구절로 쓰고 좋은 브리프를 만드는 가이드를 반환합니다.

브리프 작성

브리프에는 script와 cues가 담긴 narration, 그리고 shots를 담은 scenes가 있으며, shots에는 reveals가 담깁니다. 큐는 스크립트의 한 구절입니다. 리빌은 큐가 말해질 때 요소를 배치합니다.

{
  "fps": 30, "width": 1920, "height": 1080, "backgroundColor": "#0b0b0f",
  "narration": {
    "script": "Ship faster. Nodaro turns your idea into video.",
    "cues": [
      { "id": "c_ship", "text": "Ship faster" },
      { "id": "c_idea", "text": "your idea into video" }
    ]
  },
  "scenes": [
    {
      "id": "scene_hook",
      "shots": [{
        "id": "shot_1",
        "reveals": [
          {
            "id": "rv_title",
            "element": { "id": "t1", "type": "text", "text": "Ship faster", "fontFamily": "Inter", "fontSize": 120, "fontWeight": 900, "color": "#ffffff", "x": 200, "y": 450 },
            "revealAt": { "kind": "cue", "cueId": "c_ship", "edge": "start" },
            "enter": { "motion": "slide-up", "durationFrames": 12, "easing": "easeOut" }
          }
        ]
      }]
    }
  ]
}

앵커

프레임 0의 썸네일에 보여야 하는 요소에는 "enter": { "motion": "none", "durationFrames": 0 }을 쓰세요.

요소가 머무는 시간

요소는 자기 장면의 콘텐츠가 끝날 때 사라집니다. 요소가 사라지는 방식을 정하려면, 등장 후 머무는 프레임 수인 hold와 머문 뒤의 모션인 exit를 설정하세요.

타이밍을 정확하게 유지하는 규칙

• 큐는 공백까지 포함해 스크립트와 정확히 일치해야 합니다. 말하는 형태로 쓰세요. “2026”이 아니라 twenty twenty-six, “$5”가 아니라 five dollars로 씁니다.
• 장면은 시간상 겹치면 안 됩니다. 각 장면은 내레이션의 연속된 구간 하나를 차지합니다. 두 장면의 리빌이 겹치면 resolve_shot_sequence가 422 scene_overlap을 반환합니다.
• 글꼴은 Inter, Roboto, Montserrat, Poppins, Playfair Display, Bebas Neue, Anton, Caveat, Roboto Mono, Fira Code 등 지원되는 패밀리에서 고릅니다. Rubik, Heebo, Cairo, Tajawal은 히브리어와 아랍어를 지원합니다.
• 등장 모션은 fade, scale-up, wipe-in, slide-up, slide-down, slide-left, slide-right, none입니다.
• 퇴장 모션은 fade, slide-up, slide-down, slide-left, slide-right, none입니다.

트랜스크립트에서 찾을 수 없는 큐는 비례 타이밍으로 대체되며, warnings에 그 사실이 표시됩니다.

블루프린트

블루프린트는 미리 만들어진 애니메이션 비트로, blueprint 리빌로 배치하고 params로 내용을 채웁니다. list_shot_shapes는 카탈로그를 반환하고, get_shot_shape는 블루프린트 하나의 매개변수를 작업 예시와 함께 반환합니다. 블루프린트 자체에는 비용이 들지 않으며, 렌더링 가격에 동영상 전체가 포함됩니다.

기본 길이는 30fps 기준 프레임 수입니다. list_shot_shapes는 항상 현재 카탈로그를 반환합니다.

브랜드 토큰

브리프에는 팔레트, 글꼴, 로고가 담긴 브랜드 토큰을 넣을 수 있으므로, 모든 블루프린트가 내 색상과 서체를 사용합니다. 브리프에서 토큰은 프리셋 ID가 아니라 전체 객체여야 합니다. list_brand_presets에서 프리셋의 토큰을 복사하세요. 필드는 동영상 디렉터의 브랜드와 같습니다.