# 埋め込み

> 自社プロダクトに Nodaro を組み込む 2 つの方法（公開済みワークフローを実行するミニアプリと、状態を持たない 3D シーンビューポート）と、それぞれの使いどころを説明します。

Source: https://nodaro.ai/ja/docs/developers/embed

**埋め込み**を使うと、Nodaro の一部を自社プロダクトの中に組み込めます。埋め込みには 2 種類あり、それぞれ異なる課題を解決します。**ミニアプリの埋め込み**は、ユーザーのために公開済みワークフローを実行し、**3D シーンビューポート**は、何も実行せずに 3D シーンを表示し、必要に応じて編集もできます。

## 埋め込みを選ぶ
| | ミニアプリ | 3D シーンビューポート |
| --- | --- | --- |
| **できること** | 公開済みのミニアプリを実行します。入力を集め、実行を開始し、結果を表示します。 | 3D シーンプランを描画します。ビューポート、再生、オブジェクトの一覧、ポーズエディター、リビジョン履歴です。 |
| **埋め込み方法** | REST API の上に作る独自のインターフェース、またはミニアプリの埋め込みコードによるフレームです。 | `postMessage` で操作する、`/embed/scene3d` のフレームです。 |
| **認証** | 独自のインターフェースでは、サーバーに保管した個人用 API トークンまたは OAuth トークンを使います。フレームは、閲覧者自身の Nodaro セッションで動作します。 | 不要です。フレームはセッションを持たず、ネットワーク呼び出しも行いません。 |
| **クレジット** | 実行のたびにクレジットがかかり、実行の名義となるアカウントが支払います。 | かかりません。ビューアーはジョブを実行しません。 |
| **状態の保存場所** | 実行は Nodaro に保存されます。 | シーンは自分のページが保持します。フレームは、再読み込みをまたいで何も保持しません。 |

## ミニアプリを埋め込むタイミング
- ワークフローをミニアプリとして公開していて、自社のサイトやアプリから、ユーザーにそれを実行してもらいたいとき。[アプリ](https://nodaro.ai/docs/concepts/apps)を参照してください。
- アプリの周りに、独自のフォームとスタイルを用意したいとき。REST API の上に組み立てます。
- 最も手早い方法を使いたいとき。ミニアプリの埋め込みコードを、自分のページに貼り付けます。

[ミニアプリを埋め込む](https://nodaro.ai/docs/developers/embed/miniapps)を参照してください。

## 3D シーンビューポートを埋め込むタイミング
- 自分のプロダクトが、[**3D シーン生成**（Generate 3D Scene）](https://nodaro.ai/docs/nodes/video/generate-3d-scene)や [**3D シーン編集**（Edit 3D Scene）](https://nodaro.ai/docs/nodes/video/edit-3d-scene)のジョブによる 3D シーンプランを保存していて、ユーザーがそれを見られるようにしたいとき。
- ユーザーがシーンを再生、スクラブし、シーン内のオブジェクトを選択できるようにしたいとき。デフォルトは読み取り専用です。
- ユーザーがポーズ、色、ロックを編集できるようにし、新しいリビジョンはそのつど自分のページで保存したいとき。

[3D シーンビューポートを埋め込む](https://nodaro.ai/docs/developers/embed/scene3d)を参照してください。ビューポートが描画するデータについては、[3D シーン形式](https://nodaro.ai/docs/developers/embed/scene3d-format)を参照してください。

## どちらも、トークンをブラウザーに置かない
どちらの埋め込みも、Nodaro のトークンを Web ページの中に置くことはありません。独自のミニアプリのインターフェースを作る場合、トークンは自分のサーバーに置かれたままです。3D シーンビューポートのメッセージには、トークンが一切含まれません。自分のページが、シーンのアセットを自分のセッションで取得し、そのバイトデータを送ります。

## Frequently asked questions

### Nodaro から何を埋め込めますか？

2 つあります。シンプルなフォームを持つ公開済みワークフローである「ミニアプリ」と、自分のページが送った 3D シーンプランを描画する「3D シーンビューポート」です。

### AI の生成を実行するのは、どちらの Nodaro 埋め込みですか？

ミニアプリの埋め込みだけです。3D シーンビューポートは何も実行せず、セッションを持たず、ネットワーク呼び出しも行わず、クレジットも一切使いません。

### 3D シーンビューポートを埋め込むのに、API トークンは必要ですか？

必要ありません。ビューポートには、トークンもセッションも不要です。自分のページが postMessage でシーンを送り、シーンのバイナリアセットは、自分のセッションで取得します。

### ミニアプリ用に独自のインターフェースを作る場合、トークンはどこに置きますか？

自分のサーバーに置きます。ブラウザーのコードは自分のサーバーと通信し、自分のサーバーがそのトークンで Nodaro API を呼び出すので、トークンがブラウザーに渡ることはありません。