嵌入 Muapi 工具
Muapi 提供两种独立的 iframe 嵌入方式：用于单个生成模型的模型嵌入，以及用于对话式画布的 Creative Agent 嵌入。每个嵌入都关联到创建它的 Muapi 账户。
嵌入模型 Playground
- 登录 Muapi 账户，打开 Playground 中对应模型的页面。
- 选择 Embed 标签页。Muapi 会为该模型生成嵌入代码。
- 复制 iframe 代码片段，并添加到你希望显示生成器的网页中。
嵌入内容会打开所选模型的生成表单。输入项和选项会随该模型当前的 Playground 参数定义变化。通过嵌入发起的生成任务使用嵌入代码关联的账户，并从该账户扣除额度。只有在你愿意让访客使用该账户余额提交生成任务时，才应公开嵌入代码。
嵌入 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 嵌入；不再需要时，可在那里撤销嵌入。
将 Agent 嵌入限制为指定网站
Agent 嵌入支持可选的允许来源列表。创建 Agent 嵌入时，可通过 POST /api/v1/agent-embeds 设置；也可通过 PATCH /api/v1/agent-embeds/{embed_id} 更新。请填写主机名，例如 example.com。设置列表后，来自其他来源的请求会被拒绝。列表为空时，任何来源都可使用；如需限制访问，请添加你控制的网站。
此来源设置仅适用于 Creative Agent 嵌入。模型 Playground 嵌入代码使用另一套机制，没有相同的允许来源设置。
管理和排查嵌入
- 请将嵌入代码视为凭据：获得代码的人可能可以使用关联工具，并在所有者账户中产生用量。
- 如果 iframe 空白或显示嵌入不可用，请确认代码完整，且对应模型或 Agent 仍然可用。
- 如果 Agent 嵌入受到限制，请核对浏览器页面的主机名是否在允许来源列表中。
- 对于模型嵌入，请在发布前于模型 Playground 页面查看参数和费用。