# アプリ（ミニアプリ）

> ミニアプリは、専用の URL を持つシンプルなフォームとして公開したワークフローです。利用者が入力する項目、表示モード、共有、料金、埋め込みを設定できます。

Source: https://nodaro.ai/ja/docs/concepts/apps

**ミニアプリ**は、シンプルなアプリとして公開したワークフローです。利用者が短いフォームに入力して**実行**をクリックすると、Nodaro が裏側のワークフローを実行し、結果を表示します。利用者にキャンバスが見えることはありません。ミニアプリにはそれぞれ専用の URL、実行履歴、バージョンがあります。

## ミニアプリの仕組み
| | 作成者（あなた） | アプリを実行する人 |
| --- | --- | --- |
| **見えるもの** | キャンバス上のワークフロー全体 | 作成者が選んだ入力と結果だけ |
| **すること** | ワークフローを作り、入力と出力を選んで公開する | 入力項目を埋めて**実行**をクリックする |
| **費用** | 公開は無料 | 実行にかかるクレジット。自分の残高から支払い、金額は**実行**ボタンに表示される |

Workflow: アプリには 2 つの入力と 1 つの出力が表示されます。その間にあるものはすべて、フォームの裏側で実行されます。

- テキスト → 画像生成 (プロンプト)
- スタイル → 画像生成 (ルック)
- 画像生成 → 動画生成 (開始フレーム)

## ワークフローをミニアプリとして公開する
### 「プレゼン」タブを開く
ワークフローを開き、エディター上部の**プレゼン**をクリックします。「プレゼン」タブでは、利用者に見える画面を組み立てます。利用者が入力する項目、受け取る結果、そしてその周りに置くタイトル、グループ、短いテキストです。

### 入力と出力を選ぶ
利用者に入力してもらうフィールドを持つノードを追加します。たとえば、プロンプト、画像のアップロード、ピッカーです。次に、利用者に結果を見せるノードを追加します。それぞれにタイトルと説明を付けます。選択肢のリストでは、利用者が選べる値を制限できます。

### 「公開」をクリックして「ミニアプリ」を選ぶ
**公開**をクリックし、**ミニアプリ**を選んで、**ミニアプリ名**と説明を入力します。**URL スラッグ**は省略できます。空欄のままにすると、Nodaro が名前から作成します。

### アプリのオプションを設定して公開する
下の表のオプションを選び、**アプリを公開**をクリックします。**ミニアプリを開く**を使うと、利用者に見えるとおりに確認できます。

| オプション | 内容 |
| --- | --- |
| **マーケットプレイスに掲載** | 選んだカテゴリー、出力の種類、タグとともに、「ミニアプリ」ページの**探す**タブにアプリを掲載します。掲載しないアプリも、リンクからは開けます。 |
| **RemX に対応** | 利用者がアプリをカスタマイズしたり、リミックスしたりできるようにします。 |
| **読み取り専用** | 利用者は結果を見られますが、入力は編集できません。 |
| **許可する表示モード** | 利用者が切り替えられるレイアウトです。[表示モード](#view-modes)を参照してください。 |
| **デフォルトの表示モード** | アプリを開いたときのレイアウトです。 |
| **比較のデフォルト** | **並べて比較**モードで最初に左右に並べて表示する 2 つのノードです。 |
| **実行のサムネイル** | 実行一覧で、各実行のサムネイルにする結果をどのノードから取るかを指定します。 |

公開したアプリの URL は、`app.nodaro.ai/app/` の後にスラッグを付けたものです。URL はバージョンが変わっても同じです。ワークフローを変更したらもう一度公開してください。共有済みのリンクはすべて、新しいバージョンを開きます。

## 表示モード
作成者は、アプリで使える表示モードと、アプリを開いたときの表示モードを選びます。アプリを実行する人は、許可されたモードを切り替えられます。

| モード | 見た目 |
| --- | --- |
| **左右分割** | 左に入力、右に結果を表示します。 |
| **縦並び** | 上に入力、下に結果を表示します。幅の狭い画面に向いています。 |
| **ギャラリーグリッド** | 入力と結果をカードのグリッドで表示します。 |
| **全画面スライドショー** | 結果を 1 つずつ全画面で表示します。 |
| **並べて比較** | 2 つの結果を横に並べて表示します。 |
| **チャット** | 下部の入力欄に入力項目がまとまり、各実行がスレッドのメッセージとして表示されます。 |

### チャットモード
チャットモードでは、アプリを会話の形で使えます。アプリの許可する表示モードに**チャット**を追加するまではオフです。デスクトップとモバイルの両方で動作します。

- **入力欄はチップの列です**。各入力は小さなチップで、クリックすると値を編集できます。アップロード用のチップには、ファイルを追加するとサムネイルが表示されます。
- **実行ボタンで始めます**。新しい実行を始める専用のボタンはありません。**実行**をクリックすると実行が始まり、そのクレジット料金が表示されます。入力欄の値はそのまま残るので、1 つだけ変えてもう一度実行できます。
- **一度に 1 回ずつ実行します**。実行中は入力欄がロックされ、実行が終わると再び使えるようになります。
- **各実行はスレッドに残ります**。複数のステップがある実行では、ステップごとにチップが表示され、ステップが完了するとチェックが付きます。同じ値でもう一度実行するには**入力を再利用**、ステップの結果を開くには**ステップを表示**、結果を保存するには**ダウンロード**を使います。
- **結果を全画面で表示できます**。結果をタップすると全画面で開きます。← と → でその実行の入力と結果を順に移動し、↑ と ↓ で実行を切り替え、Esc で閉じます。

## アプリの利用者に見えるもの
- **あなたが選んだものだけ**。「プレゼン」タブに配置した入力と結果が、あなたが付けたタイトルやテキストとともに表示されます。
- **前後のテキストは見えません**。ノードの[前後のテキスト](https://nodaro.ai/docs/concepts/prompt-pre-post-text)はすべてのプロンプトの前後に付きますが、アプリには表示されません。独自のスタイル指定に使ってください。
- **送信先は変更できません**。アプリの送信先と取得先は固定されています。たとえば、[**Webhook 出力**（Webhook Output）](https://nodaro.ai/docs/nodes/publish/webhook-output)のアドレス、SNS アカウント、スクレイパーの取得対象です。アプリを実行する人は、これらを変更できません。
- **支払いは利用者自身の残高から**。アプリを実行するにはログインが必要で、各実行は利用者自身のクレジットで支払われます。アプリには、残高で何回実行できるかが表示されます。

保存済みのキーで送信する Webhook 出力ノードがある場合は、アプリを公開する前に、そのキーを 1 つのアドレスに固定する必要があります。公開ダイアログから、その場でキーを固定できます。詳しくは [Webhook 出力](https://nodaro.ai/docs/nodes/publish/webhook-output)を参照してください。

## 公開せずにプレゼンリンクで共有する
「プレゼン」タブでは、ワークフローを公開せずに共有することもできます。共有ダイアログで作成したリンクを使えば、誰でもワークフローを実行できます。クレジットは実行する人が支払います。ダイアログの**閲覧者の設定**には、**閲覧者は結果のみ表示できます**、許可する表示モード、デフォルトの表示モードがあります。**共有を取り消す**をクリックすると、リンクが無効になります。

変わらない URL、実行履歴、バージョン、分析、「ミニアプリ」ページへの掲載が必要な場合は、ミニアプリとして公開します。手早くレビューしてもらうときは、共有リンクを使います。

## ミニアプリを管理する
サイドバーの**ミニアプリ**を開きます。このページには 3 つのタブがあります。

- **探す**：掲載されているすべてのミニアプリです。検索したり、**人気順**、**新しい順**、**お気に入りの多い順**で並べ替えたりできます。
- **マイミニアプリ**：自分が公開したアプリです。実行回数、1 回あたりの料金、お気に入りの数が表示されます。各カードから、アプリやそのワークフローを開いたり、URL や埋め込みコードをコピーしたりできます。**分析**の確認、設定の編集、掲載と掲載の停止、無効化もできます。
- **お気に入り**：ハートを付けたアプリです。

ミニアプリを削除すると、マーケットプレイスと自分の一覧に表示されなくなります。**削除したミニアプリ**からいつでも復元でき、収益、分析、実行履歴は保持されます。

## ミニアプリを有料にする
Nodaro Cloud では、ほかの人があなたのミニアプリを実行したときに上乗せ料金を請求できます。アプリのカードから**ミニアプリの設定を編集**を開き、**収益化**で、クレジット単位の固定料金、割合、またはその両方を設定します。ダイアログには、利用者が支払う金額として、実行の基本料金とあなたの上乗せ料金の合計が表示されます。「ミニアプリ」ページの**収益化のデフォルト**では、ミニアプリで初めて収益化をオンにしたときに適用される料金と割合を設定します。

収益はチャージ残高に加算され、12 か月間有効です。**請求**ページの**ミニアプリの収益**に、今月、過去 30 日間、全期間の収益が表示されます。詳しくは[クレジット](https://nodaro.ai/docs/concepts/credits)を参照してください。

## ミニアプリを埋め込む、またはコードから実行する
**Web サイトに埋め込む**。アプリのカードの**埋め込み**をクリックすると、埋め込みコードをコピーできます。先に、アプリの表示を許可する Web サイトを**埋め込みの設定** › **埋め込みを許可するドメイン**に追加してください。ドメインを 1 つ以上追加するまで、埋め込みはブロックされます。

**自分のコードから実行する**。自分の Web サイトやアプリから、REST API で公開済みのミニアプリを実行することもできます。サーバーがアプリの入力を読み取り、実行を開始して、結果を待ちます。アプリの識別子はスラッグ、つまり URL の最後の部分です。実行は非同期なので、サーバーは実行を開始してから結果を確認します。コード付きの手順全体は、[ミニアプリを埋め込む](https://nodaro.ai/docs/developers/embed/miniapps)で説明しています。

[MCP](https://nodaro.ai/docs/mcp) で接続したアシスタントも、あなたのアプリを一覧表示して実行できます。[CLI](https://nodaro.ai/docs/developers/cli) では、`nodaro apps run` でアプリを実行します。

ワークフローをフォームとしてではなく、ほかのワークフローの中で再利用したい場合は、[コンポーネント](https://nodaro.ai/docs/concepts/components-and-sub-workflows)として公開します。1 つのワークフローを、ミニアプリとコンポーネントの両方として公開することもできます。

## Frequently asked questions

### Nodaro のミニアプリとは何ですか？

ミニアプリは、専用の URL を持つシンプルなアプリとして公開したワークフローです。利用者は、あなたが選んだ入力項目に入力して「実行」をクリックします。Nodaro がワークフローを実行し、キャンバスを見せずに結果を表示します。

### ミニアプリの実行料金は誰が支払いますか？

アプリを実行する人が、自分のクレジットで支払います。料金は実行前に「実行」ボタンに表示されます。Nodaro Cloud では上乗せ料金を設定することもでき、その分は収益としてあなたのチャージ残高に加算されます。

### アプリの利用者に、自分のプロンプトや設定は見えますか？

利用者に見えるのは、あなたがアプリに配置した入力と結果だけです。前後のテキストが表示されることはありません。また、Webhook のアドレスや SNS アカウントなど、外部に送信するノードの送信先は、アプリを実行する人には変更できません。

### 公開済みのミニアプリを更新するにはどうすればよいですか？

ワークフローを変更してから、「プレゼン」タブでもう一度公開します。URL はバージョンが変わっても同じなので、共有済みのリンクはそのまま使えます。

### ミニアプリを自分の Web サイトに載せられますか？

はい。アプリのカードから埋め込みコードをコピーし、「埋め込みを許可するドメイン」に自分の Web サイトを追加します。独自のインターフェースを作る場合は、サーバーから REST API で実行を開始し、結果を取得できます。