Muapi ツールの埋め込み

Muapi には 2 種類の iframe があります。単一モデル用のモデル埋め込みと、会話型キャンバス用の Creative Agent 埋め込みです。各埋め込みは作成した Muapi アカウントに紐づきます。

モデル Playground の埋め込み

  1. サインインして Playground のモデルページを開きます。
  2. Embed タブを選び、コードを生成します。
  3. iframe スニペットをコピーしてサイトに追加します。 フォームにはモデルの現在のパラメーターが反映されます。生成は関連アカウントのクレジットを消費するため、訪問者に残高の利用を許可できる場合だけ公開してください。

Creative Agent の埋め込み

Assistant で Agent 埋め込みを作成し、iframe をコピーして HTML に貼り付けます。

<iframe src="https://muapi.ai/embed/agent/YOUR_EMBED_CODE" style="width:100%;height:100%;border:0;" allow="clipboard-write" allowfullscreen></iframe>

iframe または親要素に高さを設定します。Assistant ページで埋め込みを取り消せます。

Agent の利用サイトを制限

作成時に POST /api/v1/agent-embeds、更新時に PATCH /api/v1/agent-embeds/{embed_id} で許可する origin を設定します。example.com のようなホスト名を指定します。リスト設定時は他の origin を拒否し、空ならすべて許可します。この設定は Creative Agent にのみ適用され、モデル埋め込みには適用されません。

管理とトラブルシューティング

埋め込みコードは認証情報として扱ってください。利用者の操作で所有者のアカウントに使用量が発生する場合があります。表示されない場合はコードとモデル/Agent の状態を確認します。制限時はホスト名を確認し、公開前にパラメーターと料金を確認してください。 クレジット、モデル、Creative Canvasを参照してください。