ショットシーケンス

ショットシーケンスは、ナレーション付きのモーショングラフィックス動画です。画面上のテキスト、図形、画像のすべてが、ナレーションで対応するフレーズが話された瞬間に現れます。あなたか AI アシスタントが、ブリーフを書きます。ブリーフには、ナレーションとそのキュー、そしてシーン、ショット、リビールを記述します。Nodaro は、録音したナレーションを単語単位でアライメントし、すべてのキューを正確なフレームに焼き込みます。そのため、タイミングは確定的で、実行のたびに変わることはありません。動画ディレクターはこのパイプラインを基盤にしており、ブリーフをあなたの代わりに書きます。

パイプライン

最初に start_video_director を呼び出してください。ナレーションをキューのフレーズとして書く方法と、良いブリーフを作る方法のガイドが返されます。

ブリーフを書く

ブリーフは、script と cues を持つ narration と、scenes からなります。scenes には shots が含まれ、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 を設定します。hold は登場後に表示し続けるフレーム数で、exit はその後の動きです。

タイミングを正確に保つルール

• キューは台本と完全に一致させる：スペースも含めて一致させる必要があります。読み上げる形で書いてください。「2026」ではなく「twenty twenty-six」、「$5」ではなく「five dollars」と書きます。
• シーンの時間を重ねない：各シーンは、ナレーションの連続した 1 つの区間を受け持ちます。2 つのシーンのリビールが重なると、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 は 1 つのブループリントのパラメーターを、実例とともに返します。ブループリント自体に料金はかかりません。動画全体が、レンダリングの料金に含まれます。

デフォルトの長さは、30 fps でのフレーム数です。list_shot_shapes は、常に最新のカタログを返します。

ブランドトークン

ブリーフには、パレット、フォント、ロゴからなるブランドトークンを含められます。そうすると、すべてのブループリントが、自分のブランドの色と書体を使います。ブリーフでは、トークンはプリセット ID ではなく、完全なオブジェクトで指定する必要があります。プリセットのトークンは、list_brand_presets からコピーします。フィールドは、動画ディレクターのブランドと同じです。