アプリとコンポーネント
公開された Nodaro のアプリとコンポーネントを探し、入力を確認して、AI アシスタントから実行し、失敗した実行を再試行します。list_apps、run_app、retry_app_run を使います。
アプリとコンポーネントのツールを使うと、アシスタントは、ユーザーが公開したワークフローを利用できます。アプリは、写真の修復やテーマに沿った編集など、シンプルなフォームを備えた公開済みのワークフローです。コンポーネントは、公開済みの構成要素です。アシスタントはアプリやコンポーネントを検索し、その入力を確認して、あなたのクレジットで実行します。
アプリは、斬新な変換、テーマに沿った編集、複数ステップのパイプラインなど、単一の生成ツールでは対応できない多くの依頼をカバーします。アシスタントは、何かができないと答える前に、アプリを検索するべきです。
list_apps
公開済みのアプリを検索します。対象は、公開マーケットプレイスか、自分のアプリです。
権限:apps:read。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
scope | string | マーケットプレイスなら public(デフォルト)、自分のアプリなら mine です。 |
search | string | 検索するトピックです。最大 100 文字です。 |
category | string | カテゴリーです。最大 50 文字です。 |
limit | integer | 1〜50 です。 |
cursor | string | 前のページのカーソルです。 |
戻り値:一致するアプリと、そのスラッグです。各アプリの estimated_credits は、アプリに記載された料金です。エピソード全体の EDL 適用のレンダーのように、料金がアプリに渡す収録の長さに応じて決まる場合、estimated_credits は固定部分で、per_minute_credits は収録 1 分あたりのクレジットです。自分で埋めるリストの入力がアプリにある場合、per_item_credits は、クリエイターが保存した項目を超える 1 項目ごとに追加されるクレジットです。どちらも、当てはまらない場合は 0 か、含まれません。
記載される料金は範囲です。上のフィールドは、アプリの保存された設定での「〜から」の料金です。max_estimated_credits、max_per_minute_credits、max_per_item_credits は「最大」の料金で、アプリの利用者が選べる選択肢の中で、1 回の実行にかかりうる最も高い金額です。これらは「〜から」の料金と異なる場合にだけ含まれます。範囲が導入される前に公開されたアプリには、次に公開されたあとで含まれるようになります。
記載される料金に従量課金の LLM 呼び出しが含まれる場合、その行には estimated_credits_is_estimate: true が付きます。この場合の数値はそのモデルの一般的な呼び出しの料金で、実行は呼び出しで実際に使ったトークンに応じて課金されます。そのため、料金は ≈N と表示してください。固定料金の場合、このフィールドは含まれません。
公開作品を許可していない(outputs.allowPublic: false)、またはアプリページを非表示にしているデプロイメントでは、公開のスコープには何も表示されず、{ "data": [], "scope": "public", "next_cursor": null } が返ります。自分のアプリは、scope: "mine" で引き続き一覧表示されます。
get_app_inputs
アプリの入力を返します。アプリのページに表示されるものと同じフォームです。run_app の前に呼び出して、入力のキーを確認します。
権限:apps:read。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
slug | string | 必須。アプリのスラッグです。たとえば photo-restoration です。 |
戻り値:アプリの slug、name、description と、入力ごとに 1 つのエントリーです。各エントリーには、key、label、type(image、video、audio、text、select、number、boolean、list、color のいずれか)、required かどうか、select の場合は options が含まれます。
- アプリが公開しているスライダー(テキストから音声の安定性、LLM の温度、長さなど)は
type: "number"で、スライダー自身のmin、max、stepが付きます。run_appは、この入力に数値か数値の文字列を受け付けます。 - アプリが公開しているクイック設定(ノードのモデル、解像度、長さ、アスペクト比、ドラフトの選択など)は、受け付ける値によって型が決まります。値を
optionsに並べたselect、範囲内の任意の値を受け付ける設定ならminとmaxが付いたnumber、ドラフトやインストゥルメンタルのような設定ならbooleanです。選択肢がノードのモデルによって変わる場合、optionsにはすべてのモデルの値が並び、descriptionにそのことが書かれています。ノードのモデルが受け付ける値を選んでください。これらの入力では、run_appは数値の文字列を数値に、"true"または"false"を boolean に変換します。固定されたリストにない値は、400 validation_errorで拒否されます。 - 動画 URL の入力は
type: "video"で、required: trueです。値は動画へのリンクで、動画のページ、またはそのほかの公開 Web リンクです。Web リンクではない値は、400 locked_fieldで拒否されます。Nodaro が先に動画の長さを読み取るサイトでは、4 分以上の動画は、inputOverridesでノードにsectionStartSecとsectionEndSecを指定した部分だけがダウンロードされます。部分の指定がない実行は、何かが課金される前に拒否されます。
公開作品を許可していないデプロイメント(outputs.allowPublic: false)では、アプリは作成者だけのものです。ほかの人のアプリは、不明なスラッグと同じように App "<slug>" not found. と返ります。
run_app
公開済みのアプリを実行します。実行のクレジットは、あなたが支払います。
権限:workflows:execute。クレジット:アプリの中で実行されるノードのクレジットです。
| パラメーター | 型 | 説明 |
|---|---|---|
slug | string | 必須。アプリのスラッグです。 |
inputs | object | get_app_inputs で確認した入力のキーをキーとする、フラットなオブジェクトです。省略すると、デフォルト値が使われます。 |
inputOverrides | object | 上級者向けです。ノード ID とフィールドをキーとする、ノードの生のフィールドです。inputs の上から適用されます。たとえば { "n1": { "promptPrefix": "..." } } です。null にしたフィールドは、この実行に限ってクリアされます。ノードは、クリエイターが保存した値ではなく、値なしで実行されます。 |
client_request_id | string | 再試行用のトークンです。英字、数字、_ - . : からなる 8〜128 文字です。タイムアウトの後に再試行するときに同じ値を使うと、実行が二重に開始されたり、二重に課金されたりしません。 |
戻り値:ワークフロー実行の ID と、実行の runId です。実行の状況は get_app_run で確認します。実行が失敗した場合は、retry_app_run にその runId を渡します。
inputOverrides では、Webhook 出力ノードの URL、公開ノードのアカウント、スクレイパーの取得先など、出力の送り先を設定できません。設定しようとした実行は、400 locked_field で拒否されます。
公開作品を許可していないデプロイメント(outputs.allowPublic: false)では、自分のアプリだけを実行できます。ほかの人のアプリは、存在しないアプリと同じように 404 not_found で拒否されます。
retry_app_run
失敗したアプリの実行を、止まった所から再試行します。アプリのページの再試行ボタンと同じです。実行が完了しなかったステップだけが実行され、それらの分だけが課金されます。完了したステップは、それぞれの結果を引き渡します。失敗した UGC クリップは、仕上がっていないクリップだけをレンダリングします。再試行では、その実行が実行したアプリのバージョンを、その実行が適用した入力で実行し、独自の入力は受け付けません。
権限:workflows:execute。クレジット:もう一度実行されるステップの分と、アプリの作成者の手数料です。
| パラメーター | 型 | 説明 |
|---|---|---|
slug | string | 必須。アプリのスラッグです。 |
run_id | string | 必須。実行の ID です。run_app が返した runId、または再開のヒントが示す ID です。 |
version | integer | 実行されると想定するアプリのバージョンです。デフォルトはアプリの最新バージョンです。アプリが変更されたあとも実行のバージョンのまま続けるには、実行自体のバージョンを送ります。 |
confirm | boolean | この会話の中で、ユーザーが見積もりのクレジットを了承した後にだけ true にします。 |
戻り値:confirm なしの場合は見積もりで、何も開始されません。見積もりには、もう一度実行されるステップ、料金(作成者の手数料を含む estimatedCredits)、reusedClips、sufficient が含まれます。sufficient は、残高とアプリ用クレジットで再試行をまかなえるかどうかを示します。アプリ用クレジットが原因で再試行できない場合は appCreditsAllowance が含まれ、見積もりにもそのことが示されます。見積もりをユーザーに示し、了承された場合にだけ confirm: true でもう一度呼び出してください。ツールはもう一度見積もり、その際に実行も確認して、再試行を開始します。ワークフロー実行の ID が返されるので、get_app_run でポーリングします。
- 再試行は一度に 1 回。 その再試行が保留中の間に 2 回目の呼び出しを行うと、
already_runningで拒否され、エラーにはポーリングするワークフロー実行が示されます。 - アプリが変更された場合。 実行のあとでアプリが変更されている場合、通常の再試行は
app_run_version_changedで拒否され、実行のバージョンとアプリのバージョンが示されます。run_appで実行を最初からやり直すか、実行自体のバージョンを渡して、そのまま続けます。 - 最初からやり直す実行。 失敗ではなく完了したか停止された実行や、そのバージョンがもう利用できない実行は、
run_appで最初からやり直します。どちらなのかはエラーに示されます。 - プレビュー。 プレビューのレンダリングで止まる再試行は、
preview_review_requiredで拒否されます。人がプレビューを確認できるアプリのページから再試行してください。 - クレジット。 クレジットによる拒否では、アプリ用クレジットまたは残高についての、ルート自体のメッセージがそのまま示されます。
すべての拒否は、失敗した実行を再試行するに一覧があります。
公開作品を許可していないデプロイメントでは、ほかの人のアプリの実行は再試行されません(存在しないアプリと同じ 404 not_found)。get_app_run では、引き続き読み取れます。
delete_app_run
アプリの実行をアーカイブに移動します。移動した実行は、app.nodaro.ai/archived-runs で復元するか、完全に削除できます。完全に削除できるのは、実行が終了するか停止された後だけです。
権限:workflows:execute。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
slug | string | 必須。アプリのスラッグです。アプリの URL の最後の部分にあたります。 |
runId | string | 必須。実行 ID です。 |
戻り値:処理の確認です。
list_components
公開済みのコンポーネントを検索します。対象は、公開マーケットプレイスか、自分のコンポーネントです。ユーザーがコンポーネントの名前を挙げたときや、既存のコンポーネントに当てはまる複数ステップのパイプラインを求めたときに使います。
権限:workflows:read。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
scope | string | マーケットプレイスなら public(デフォルト)、自分のコンポーネントなら mine です。 |
search | string | 検索するトピックです。最大 100 文字です。 |
limit | integer | 1〜50 です。 |
cursor | string | 前のページのカーソルです。 |
戻り値:一致するコンポーネントと、そのスラッグです。それぞれに estimated_credits、per_minute_credits、per_item_credits と、対応する max_ のフィールドが含まれ、list_apps と同じように読み取ります。従量課金の LLM 呼び出しの見積もりを含む行には、list_apps と同じように estimated_credits_is_estimate: true が付きます。
公開作品を許可していないデプロイメント(outputs.allowPublic: false)では、公開のスコープには何も表示されず、{ "data": [], "scope": "public", "next_cursor": null } が返ります。scope: "mine" は、これまでどおり使えます。
get_component_inputs
コンポーネントの入力を返します。run_component の前に呼び出して、入力のキーを確認します。
権限:workflows:read。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
component_id | string | 必須。コンポーネントのスラッグです。 |
戻り値:入力ごとに 1 つのエントリーです。各エントリーには、key、label、type、required かどうかが含まれます。
公開作品を許可していないデプロイメント(outputs.allowPublic: false)では、コンポーネントは作成者だけのものです。ほかの人のコンポーネントは、不明なスラッグと同じように Component "<slug>" not found. と返ります。
run_component
公開済みのコンポーネントを実行します。
権限:workflows:execute。クレジット:コンポーネントの中で実行されるノードのクレジットです。
| パラメーター | 型 | 説明 |
|---|---|---|
component_id | string | 必須。コンポーネントのスラッグです。 |
inputs | object | get_component_inputs で確認した入力のキーをキーとする、フラットなオブジェクトです。省略すると、デフォルト値が使われます。 |
client_request_id | string | 再試行用のトークンです。英字、数字、_ - . : からなる 8〜128 文字です。タイムアウトの後に再試行するときに、同じ値を使います。 |
戻り値:ジョブ ID です。ジョブが完了すると、その output_data にコンポーネントの出力が入ります。MCP Apps に対応したクライアントでは、ジョブのカードに出力が縦に並んで表示されます。
公開作品を許可していないデプロイメント(outputs.allowPublic: false)では、run_component は自分のコンポーネントだけを実行します。ほかの人のコンポーネントは、404 not_found の「Component not found」で拒否されます。ワークフローに配置したコンポーネントは、run_workflow によるそのワークフローの実行の一部として、引き続き実行されます。
よくある質問
アプリとコンポーネントの違いは何ですか?
アプリは、シンプルなフォームから単独で実行できる、公開されたワークフローです。コンポーネントは、ほかのワークフローが再利用する、公開された構成要素です。依頼に直接対応するツールがない場合、アシスタントはまずアプリを探します。
アシスタントが開始したアプリの実行は、誰が料金を支払いますか?
あなたです。run_app と run_component は、アプリやコンポーネントの中にあるノードの料金で、あなた自身のアカウントのクレジットを使います。
アシスタントは、アプリの非表示の設定を変更できますか?
一部だけ変更できます。inputOverrides では、プロンプトの前に追加するテキストなど、ノードの生のフィールドを設定できます。ただし、Webhook の URL や SNS アカウントなど、出力の送り先は変更できません。そのような実行は拒否されます。
アシスタントは、失敗したアプリの実行をどのように再試行しますか?
アプリのスラッグと実行 ID を指定して、retry_app_run を呼び出します。最初の呼び出しでは、ステップと料金を見積もるだけです。あなたが了承すると、confirm を true にしてもう一度呼び出し、実行が完了しなかったステップだけが実行されて課金されます。
アシスタントから、アプリの実行を削除するにはどうすればよいですか?
アプリのスラッグと実行 ID を指定して、delete_app_run を呼び出します。実行はアーカイブに移動し、そこで復元するか、完全に削除できます。
関連ページ
アプリ(ミニアプリ)
コンポーネントとサブワークフロー
ギャラリーとアセット
プロジェクトとワークフロー
最終更新