NodaroAccount
Nodaro ドキュメント
ドキュメントノードリファレンスモデルテンプレートAI エージェント(MCP)開発者向けセルフホスティングリサーチ比較
ツールリファレンス

ギャラリーとアセット

AI アシスタントから、Nodaro のギャラリーとアップロードを閲覧し、結果をチャットに表示します。ジョブの詳細の読み取り、アプリの実行の追跡、お気に入りの登録もできます。

ギャラリーとアセットのツールを使うと、アシスタントは、あなたが Nodaro ですでに作ったものを探し、表示し、再利用できます。browse_gallery と browse_uploads は、結果とアップロードをグリッドで表示します。get_asset と display_asset は、1 つの結果を取得または表示します。get_app_run はワークフローやアプリの実行を追跡し、list_favorites と favorite_asset はお気に入りを管理します。どのツールもクレジットはかかりません。

ギャラリーを、操作できるサムネイルのグリッドで表示します。タイルをクリックすると、表示、コピー、次の編集での使用ができます。ユーザーが自分の作品を見たいときに使います。アシスタントがデータだけを必要とする場合は、list_jobs を使います。

権限:assets:read。クレジット:無料。

パラメーター型説明
scopestring自分のライブラリなら mine(デフォルト)、ほかのユーザーの最近の公開された結果なら public です。
kindsarray含めるメディアの種類で、image、video、audio を自由に組み合わせます。デフォルトは ["image", "video"] です。
kindstring1 つのメディアの種類で、image、video、audio のいずれかです。
querystringプロンプトの中から検索する語で、最大 200 文字です。たとえば rabbit です。すべての語がプロンプトに含まれている必要があります。大文字と小文字は区別されません。
limitinteger1〜200 です。デフォルトは 50 です。
cursorstring前のページの next_cursor です。

戻り値:MCP Apps を表示できるクライアントではグリッドが表示され、データとしては項目と next_cursor が返されます。

public スコープには、Web の公開ギャラリーに表示されるものが、同じモデレーションで表示されます。そのため、1 ページの項目が limit より少ないことがあります。next_cursor がなくなるまでたどってください。

公開作品を許可しないデプロイ(outputs.allowPublic: false)では、public スコープには何も表示されず、(no items) が返されます。自分のギャラリーは変わりません。

自分のギャラリーには、EDL 適用のレンダーも表示されます。動画のレンダーは video に、オーディオのレンダーは audio に含まれます。プレビューの品質で作ったレンダーには preview: true が付き、テキストの行には (preview) と表示されます。public スコープには、EDL 適用のレンダーは表示されません。

browse_uploads

Nodaro が生成した結果ではなく、あなたがアップロードしたファイルを表示します。以前のアップロードを、新しい生成の入力として選ぶときに使います。グリッドの Use(使用)ボタンを押すと、ファイルの ID がチャットに渡されます。

権限:assets:read。クレジット:無料。

パラメーター型説明
kindstringimage、video、audio のいずれかです。すべてのアップロードを対象にするには、省略します。
searchstringファイル名の中から検索する語で、最大 200 文字です。すべての語がファイル名に含まれている必要があります。大文字と小文字は区別されません。
limitinteger1〜100 です。デフォルトは 40 です。
cursorstring前のページの nextCursor です。

戻り値:URL と ID 付きのアップロードと、nextCursor です。プレビューの品質で作った EDL 適用のレンダーには preview: true が付き、テキストの行には (preview) と表示されます。 保存されたファイルがなくなったものは、一覧に表示されず、数にも含まれません。

get_asset

1 つの結果の詳細(出力 URL、プロンプト、モデル)を返します。自分のジョブはステータスに関係なく返し、ほかのユーザーのジョブは公開済みで完了したものを返します。公開作品を許可していないデプロイメント(outputs.allowPublic: false)では、自分のジョブだけを返し、ほかのユーザーのジョブは見つからないものとして扱われます。ほかのユーザーの公開ジョブには、失敗についてのプロバイダーの言葉(errorDetail は null)も、そのユーザーの ID も含まれません。失敗したジョブには、retryable、guidance、そしてある場合は suggestedProvider が追加されます。これらについては、ジョブが失敗したときで説明しています。

権限:assets:read。クレジット:無料。

パラメーター型説明
job_idstring必須。結果のジョブ ID です。

戻り値:input を除いたジョブエンベロープです。

display_asset

1 つの結果をチャットに表示します。ユーザーには、データではなく、画像、動画、オーディオそのものが表示されます。画像には、Animate(動画化)、Edit(編集)、Recreate(再作成)のボタンと全画面表示も付きます。アシスタントが詳細だけを必要とする場合は、get_asset を使います。

権限:assets:read。クレジット:無料。

パラメーター型説明
job_idstring必須。ステータスを問わない自分のジョブ、またはほかのユーザーの公開済みで完了したジョブです。

公開作品を許可していないデプロイメント(outputs.allowPublic: false)では、display_asset は自分のジョブだけを表示します。ほかのユーザーのジョブは見つからないものとして扱われます。

戻り値:メディアカードです。結果の詳細は、データとして返されます。

get_app_run

ワークフローの実行、または公開されたアプリの実行の進行状況を返します。内容は、実行のステータス、各ノードの状態、それまでに生成されたすべての出力 URL と、それぞれのプロンプト、モデル、ジョブ ID です。ジョブ ID ではなく実行 ID(execution_id)を返す run_workflow、render_final、run_app の後に使います。get_job では実行 ID は見つかりません。実行が pending または running の間は、5〜10 秒ごとに呼び出します。

権限:assets:read。クレジット:無料。

パラメーター型説明
execution_idstring必須。実行 ID です。

戻り値:実行のステータス、ノードの状態、それまでの出力です。

  • executionId、status、errorMessage と、total、completed、failed、skipped、skippedForEmptyInput の件数を含む summary です。
  • nodeStates は、ワークフローの順に並んだノードごとのエントリーで、id、label、nodeType、status、error、jobId、text、media を含みます。text はノードのテキスト出力で、1,500 文字で切られます。切られた場合は textTruncated: true になります。media は、ノードが生成したすべての画像、動画、オーディオの URL を、それぞれ { kind, url } として一覧表示します。skipReason: "empty_input" は、この実行でノードの入力に何も届かなかったことを意味します。
  • outputs は、実行のすべてのメディア URL で、それを作ったジョブの prompt、model、createdAt が付きます。
  • resumeHint は、run_workflow で続けられる失敗した実行(mcp プロジェクト内の保存済みワークフローで、アプリの実行ではないもの)に付きます。その実行を止まった所から続ける run_workflow の呼び出しです。失敗した実行を続けるを参照してください。失敗したアプリの実行には、代わりにアプリの再試行が付きます。これを見積もる retry_app_run の呼び出しです。これが付くのは実行の現在のワークフロー実行だけなので、再試行や新規の開始のあとは、以前のワークフロー実行には付きません。実行のあとでアプリが変更されている場合、この呼び出しには実行自体の version が示されます。

実行が完了すると、outcome も含まれます。入力に何も届かなかったためにスキップされたノードが 1 つ以上あり、何も失敗していない場合、outcome は "nothing_new" です。たとえば、新しい投稿が見つからなかったフィードです。それ以外の場合は "succeeded" です。失敗またはキャンセルされた実行には、outcome ではなく status があります。

list_favorites

お気に入りの結果のジョブ ID を、新しい順に一覧表示します。

権限:assets:read。クレジット:無料。

パラメーター型説明
limitinteger1〜100 です。
cursorstring前のページのカーソルです。

戻り値:お気に入りのジョブ ID です。お気に入りにした自分の EDL 適用のレンダーも表示され、プレビューには preview: true が付きます。ほかの人のレンダーは表示されません。公開作品を許可していないデプロイメント(outputs.allowPublic: false)では、自分のジョブだけが返されます。

favorite_asset

結果をお気に入りに追加するか、お気に入りから削除します。対象は自分のジョブでも、ほかのユーザーの公開ジョブでもかまいません。公開作品を許可していないデプロイメント(outputs.allowPublic: false)では、自分のジョブだけを登録できます。お気に入りの削除は常にできます。お気に入りにしたジョブは、list_jobs に favorited: true を付けると一覧表示できます。

権限:assets:write。クレジット:無料。

パラメーター型説明
job_idstring必須。お気に入りに登録または解除する結果です。
favoritedboolean必須。true でお気に入りに追加し、false で削除します。

戻り値:確認メッセージです。

よくある質問

Claude で Nodaro のギャラリーを見るにはどうすればよいですか?

ギャラリーを見せてほしいと頼みます。browse_gallery が、最近の画像と動画をクリックできるグリッドで表示します。プロンプトを検索することもでき、たとえばウサギが写っている画像をすべて探せます。

browse_gallery と browse_uploads の違いは何ですか?

browse_gallery は、Nodaro があなたのために生成した結果を表示します。browse_uploads は、あなたが自分でアップロードしたファイルを表示するので、その中から新しい生成の入力を選べます。

アシスタントは、公開ギャラリーの結果を使えますか?

はい。get_asset と display_asset は、自分のジョブに加えて、ほかのユーザーの公開済みで完了したジョブも返します。そのため、アシスタントは公開された結果の URL をほかのツールに渡せます。公開作品を許可していないデプロイメントでは、自分のジョブだけを返します。

アシスタントが開始したワークフローの実行を追跡するにはどうすればよいですか?

run_workflow または run_app が返した実行 ID で、get_app_run を呼び出します。実行のステータス、各ノードの状態、それまでに生成されたすべての出力が表示されます。

最終更新

目次