Nodaro ドキュメントスタジオプロダクション
AI アシスタントからスタジオプロダクションとして映画を監督します。プランを無料で検証し、見積もりを確認してフレームとモーションを生成し、Studio で編集を続けられます。
Nodaro Cloud で利用できます
スタジオプロダクションは、AI アシスタントが会話から監督でき、あなたが studio.nodaro.ai のスタジオで編集を続けられる映画です。プロダクションは順番に並んだシーンのリストで、各シーンには、フレーム、任意のモーション、そしてそれらを作ったプラン、ルック、キャスト、ボイスがあります。アシスタントは映画の下書きを作ってあなたに渡し、あなたがシーンを 3 つ動かした後でも、作業を再開できます。スタジオプロダクションは、Nodaro Cloud の機能です。
「映画やシーン、シーケンスを作って、その後も編集させて」という依頼には、この方法を選びます。1 つの JSON ドキュメントとして書く映画については Recast を、キャンバス上のワークフローについては Film Director を参照してください。
2 つの用語体系
エディターとプロダクションのドキュメントでは、同じものを違う名前で呼びます。ユーザーが目にするのはエディターだけなので、アシスタントはエディターの言葉で話し、ドキュメントの名前はツール呼び出しにだけ使います。
| ユーザーの言葉 | ドキュメントの言葉 |
|---|---|
| 映画 | プロダクション |
| シーン（タイムライン上のカード。たとえば「シーン 3」） | shot_id で指定する、shots[] のエントリー |
| シーンのフレーム（その結果はテイク） | still |
| シーンのモーション（その結果はテイク） | clip |
| モーションの中のショット | set_beats で設定する beats[] |
- 「シーン N」は、常に
shots[]の N 番目のエントリーです。「シーン 3 の名前を変えて」はそのエントリーに対するrename_shotで、「シーン 3 を削除して」はそのエントリーに対するremove_shotです。 - 「ショット」は、モーションの中のショットを指します。つまり、ユーザーが見ているシーンの
beats[]のエントリーで、shots[]のエントリーを指すことはありません。表示中のシーンがない場合や、そのモーションのショットがユーザーの指定より少ない場合、アシスタントは推測せずに質問します。 - シーンのフレームは、その
stillです。計画フレームは別のものです。generate_studio_keyframeで作る、ユーザーが確認して採用するフレームのプランです。シーンの開始フレームと終了フレームは、そのモーションの始点と終点です。 - レシートでは、ドキュメントの言葉が使われます。操作の名前と編集の
receiptsでは、シーンのことを「shot」と書きます。アシスタントは、その言い方をユーザーにそのまま繰り返すべきではありません。
作業の流れ
ガイドを読む
get_studio_production_skill は、ガイドを 4 つのパートで返します。operating（ツール、作業の流れ、操作）、authoring（プランの形式）、catalog（すべてのピッカー、モデル、オプション）、schema（プランの JSON Schema）です。ガイドは稼働中のデプロイメントから生成されるので、使っているサーバーと一致します。無料です。
プランを検証する
validate_studio_plan は、プランを無料でチェックします。何も保存せず、キャストの名前を自分のライブラリと照合します。クレジットを使う前に、プランが有効になるまで、各 errors[].path を修正します。
プロダクションを作成する
create_studio_production は、新しい映画を作成します。プランを渡した場合は、そのプランのシーンも含めて作成します。import_studio_production は、既存の映画にプランのシーンを追加します。どちらも無料です。プランのないストーリーの場合は、describe_studio_production が、LLM の実行として、監督（Director）にシーンを書かせます。
読み込み直す
get_studio_production は、現在の状態の映画と、まだ実行中のものを示す pending ブロックを返します。書き込み権限がある場合、読み込みの前に、完了したものがすべて反映されます。そのため、完了した生成は、読み込み直すことでシーンに届きます。1 つのシーンだけを軽く読み込むには、shot_id を渡します。
生成する
generate_studio_still はシーンのフレームを、generate_studio_clip はシーンのモーションを作ります。new_studio_shot_from_frame はモーションからフレームを取り出し、voice_studio_shot はセリフを読み上げます。revoice_studio_clip はモーションの声を差し替え、score_studio_production はサウンドトラックを作ります。
エクスポートと共有
plan_studio_export は、映画を組み立てるステップを、それぞれの料金とともに一覧にします。share_studio_production は共有リンクを有効または無効にし、clone_studio_production はコピーを作ります。
会話を途中でやめても、何も取り残されません。プロダクションは、エディターで開ける実際の映画です。実行中だった生成は、次にプロダクションが最新の状態に更新されたときに反映されます。更新するのは、あなた、エディター、次のアシスタントのいずれでもかまいません。
操作による編集
プロダクションへの変更は、すべて操作です。操作を適用するツールは、edit_studio_production だけです。バッチは、ドキュメントの最新のバージョンに対して、1 つのステップとして適用されます。
- 操作は、安定したキーで対象を指定します。シーンは ID で、キャストメンバーはロールのスラッグで、結果はジョブ ID か URL で指定します。位置では指定しません。ユーザーがブラウザーで、同じ映画を編集しているかもしれないためです。
- 少し古いバージョンをもとに作ったバッチも、そのまま適用されます。その場合、応答にはリベースされたことが示されます。
expected_versionとともにstrict: trueを指定すると、代わりに拒否されます。 - 1 つでも不正な操作があると、バッチ全体が拒否され、何も書き込まれません。エラーには、0 から数えたインデックスで、その操作が示されます。修正して、バッチをもう一度送ってください。
receiptsには、操作ごとに過去形の 1 行が入ります。何が起きたのかをユーザーに聞かれたら、これを見せます。- 一部の削除は元に戻せます。削除したシーン、テイク、計画フレームは、プロダクションのゴミ箱に移動し、復元できます。キャストメンバー、ボイス、サウンドトラックのクリア、カットの削除、シーケンスの除去、ゴミ箱の項目の完全削除、ゴミ箱を空にする操作は、元に戻せません。
- 共有は操作ではありません。共有には専用のツールがあるので、編集のバッチで作品の閲覧者が変わることはありません。
- プロダクションは削除できません。アーカイブは操作の 1 つで、元に戻せます。
操作の一覧は、このページには載せず、サーバーから提供されます。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 を読み取ります。
クレジットの消費
映画を監督するアシスタントは、何十回もツールを呼び出します。そのため、次の 2 つの習慣が重要です。
- 先に見積もる：
generate_studio_stillとgenerate_studio_clipは、dry_run: trueを受け付けます。この場合、モデルと料金を返し、何も書き込みません。credits: nullは料金が不明という意味で、無料という意味ではありません。料金を見せて、ユーザーに承認してもらいます。ほかのクレジットを消費するツールには、見積もりがありません。モデルから料金を見積もるか、先にユーザーに確認します。 - 安全に再試行する：クレジットを消費するツールは、すべて
client_request_idを受け付けます。値は、A-Za-z0-9_.:-からなる 8〜128 文字です。同じトークンで呼び出すと、最初の呼び出しのジョブが返され、新たな料金はかかりません。新しいリクエストごとに新しいトークンを作り、トークンなしでクレジットを消費する呼び出しを再試行しないでください。
生成は、実行、ポーリング、反映の順に進みます。
- フレームやモーションの呼び出しは、すぐにジョブ ID を返します。
get_jobでジョブを待つか、プロダクションのpendingブロックを監視します。get_studio_productionで、プロダクションをもう一度読み込みます。書き込み権限がある場合、読み込みは、応答する前に、完了したすべてのジョブを反映します。- 届いたものを、ユーザーに見せます。
読み取り専用の権限では、読み込んでも何も反映されません。完了したジョブは、書き込みが許可された誰かがプロダクションを最新の状態に更新するまで、pending に残ります。
確認マーク
クレジットを消費するツールや、作品を見られる人を変更するツールは、自身の定義の _meta.nodaro.confirm でそのことを示します。クライアントは、独自のリストを管理しなくても、マークの付いたすべてのツールの前に、確認のプロンプトを表示できます。
| マーク | 事前に確認する理由 | ツール |
|---|---|---|
$ | クレジットがかかります。 | describe_studio_production、generate_studio_still、generate_studio_keyframe、generate_studio_clip、new_studio_shot_from_frame、voice_studio_shot、revoice_studio_clip、score_studio_production |
P | 作品を見られる人が変わります。 | share_studio_production |
edit_studio_production にはマークがありません。バッチの動作は、その中の操作によって決まるためです。削除の前に確認するには、バッチをプレビューします。プレビューでは、すべての操作が分類されます。
権限
クレジットを消費する 7 つのツールには、workflows:write と workflows:execute の両方が必要です。2 つのうち一方しか許可していない接続では、これらのツールが説明なしに 1 つも表示されません。生成を行うには、両方を許可してください。読み取りには workflows:read が、作成、編集、共有、複製には workflows:write が必要です。各ツールの権限とパラメーターは、ツールリファレンスに記載されています。
提供状況
スタジオプロダクションを提供していないデプロイメントでは、このファミリーのすべてのツールが not_available を返します。これは単純な拒否で、再試行しても意味はありません。この機能を提案する前に、list_studio_productions を呼び出して確認してください。
プランの形式が記載されている場所
プランの形式 nodaro-studio-production が公開されている場所は、1 か所だけです。Studio アプリは、同じ作成ガイド、カタログ、JSON Schema を studio.nodaro.ai/skills/studio-production/ で提供しています。そのため、get_studio_production_skill を読むアシスタントと、そのページを読む人は、同じドキュメントを読むことになります。
同じプロダクションの機能は、REST の スタジオプロダクションと、SDK の client.studio.productions でも使えます。
よくある質問
関連ページ
スタジオプロダクション
スタジオプロダクション
Recast
Film Director
ジョブ
最終更新