スタジオプロダクション

スタジオプロダクションのツールは、studio.nodaro.ai の Nodaro Studio のエディターで開く映画を作成、変更します。このページでは、各ツールのパラメーターを一覧で示します。作業のループ、ユーザーとのやり取りで使う言葉、編集操作、クレジットを使うときのルールは、スタジオプロダクションで説明しています。先にそちらを読んでください。

スタジオプロダクションは Nodaro Cloud の機能です。この機能がない環境では、このグループのツールはすべて not_available を返します。機能を提案する前に、list_studio_productions を呼び出して確認してください。

ツール、権限、料金

クレジットを消費するツールと、作品を見られる人を変える share_studio_production には、ツールの定義に、実行前の確認を求めるマークが付いています。クレジットを消費するツールは、8〜128 文字の再試行用のトークン client_request_id を受け付けます。タイムアウトの後に同じ値をもう一度送っても、処理が 2 回開始されたり、2 回課金されたりすることはありません。

計画と読み取り

get_studio_production_skill

アシスタントがプロダクションの作業を始める前に読むガイドを返します。ガイドは、稼働中の環境から生成されます。

validate_studio_plan

作成したプランを無料でチェックします。何も保存しません。また、cast のすべての名前を、あなた自身のキャラクター、ロケーション、オブジェクト、クリーチャーと照合します。

戻り値：valid、errors（それぞれ対象のフィールド名を含む）、warnings、そして、キャストの名前のうちいくつがライブラリと一致したかを示す summary です。エラーを修正し、valid が true になるまで呼び出しを繰り返してください。

list_studio_productions

あなたのプロダクションを、新しい順に一覧表示します。ID、名前、バージョン、サムネイル、共有されているかどうか、シーンの数を返します。ダッシュボードと同じく、アーカイブ済みのプロダクションは表示されません。

get_studio_production

1 つのプロダクションを返します。フィルムルック、キャスト、フォルダー、カット、ゴミ箱、実行中の処理、タイムライン順のシーンが含まれます。workflows:write がある場合は、まず前回の読み取り以降に完了したすべてのジョブの結果を反映します。そのため、完了した生成の結果は、この読み取りによってシーンに届きます。

戻り値：プロダクションと、まだ実行中の処理を示す pending ブロックです。結果は、key、ジョブ ID、または URL で指定してください。位置（何番目か）では指定しないでください。

plan_studio_export

プロダクションを書き出すための手順を、順番どおりに、クレジットの見積もりとともに返します。何も開始せず、何も請求しません。ユーザーが承認する前に、この内容を見せてください。

作成と変更

create_studio_production

あなた自身の Studio プロジェクトに、プロダクションを作成します。作成したプロダクションは、すぐに studio.nodaro.ai のダッシュボードに表示されます。プランを指定すると、すべてのシーン、キャストの割り当て、フィルムルックが一緒に反映されます。指定しない場合、プロダクションは空です。先にプランを検証してください。

import_studio_production

プランのシーンを既存のプロダクションに追加し、新しいキャストを登録します。プロダクションの名前を変えたり、ブリーフやルックを変更したりすることはありません。

edit_studio_production

操作のバッチでプロダクションを変更します。たとえば、シーンの名前の変更、タイムラインの並べ替え、テイクの選択、シーンのモーション内のショットの設定、キャストの登録、ゴミ箱を空にする操作などです。操作とその引数は、part: "operating" を指定した get_studio_production_skill が提供します。

戻り値：receipts です。操作ごとに 1 行ずつ、何を行ったかが過去形で記録されます。バッチは 1 つのステップとして適用されます。1 つの操作が拒否されると、応答にはその操作のインデックスが示され、何も書き込まれません。少し古いバージョンに対して作成したバッチも適用され、その場合は rebased: true で示されます。

share_studio_production

プロダクションを共有リンクで公開するか、非公開に戻します。共有されたプロダクションは、リンクを知っている人なら誰でも閲覧できます。そのため、先にユーザーに確認してください。共有の状態を変えられるのは、このツールだけです。

clone_studio_production

自分のプロダクション、または共有されたプロダクションを、自分の Studio プロジェクトにコピーします。コピーは非公開の状態で始まり、グラフと、反映済みのすべての結果を引き継ぎます。リスクのある編集をまとめて行う前に使ってください。

生成

生成ツールは、すぐにジョブ ID を返します。完成した結果がシーンに加わるのは、次に get_studio_production を呼び出したときだけです。get_job と wait_for_job は状態を報告するだけで、結果は反映しません。

describe_studio_production

ブリーフを監督（Director）に渡します。監督は、シーン、キャスト、ルックをプロダクションに書き込みます。ユーザーの手元にプランではなくストーリーがある場合に使います。

generate_studio_still

シーンにすでにある情報（プロンプト、リファレンス、キャスト、演出）から、シーンのフレームの候補を生成します。もう一度生成するとテイクが追加されます。既存のテイクが置き換えられることはありません。

generate_studio_keyframe

計画フレームの候補を 1 つ生成します。計画フレームは、ユーザーが確認して承認するフレームで、シーンのフレームとは別のものです。派生したフレームには、承認済みの親フレームが必要です。このツールには見積もりがなく、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

シーンの現在のモーションから 1 フレームを取り出して活用します。呼び出しは抽出が終わるまで待ち、更新されたプロダクションを返します。

voice_studio_shot

1 行のテキストを読み上げ、ナレーションとしてシーンに重ねます。呼び出しは音声の生成が終わるまで待ち、更新されたプロダクションを返します。

revoice_studio_clip

シーンの現在のモーションに含まれる声を差し替えます。セリフが新しい声で演じ直され、同じ映像にミックスし直されます。

score_studio_production

音楽の説明から、プロダクション全体に使うサウンドトラックを 1 曲作ります。