用途：在网页或 Web 应用中把 Photopea 作为图像编辑引擎嵌入，用宿主页面的 JavaScript 控制嵌入实例，实现打开文件、运行脚本、导出结果等图像编辑自动化，或为产品加入图像编辑功能。
库与安装：使用 photopea.js（yikuansun/PhotopeaAPI），它是 Photopea Live Messaging API 的 Promise 封装，避免直接用 postMessage。CDN：<script src="https://cdn.jsdelivr.net/npm/photopea@1.1.1/dist/photopea.min.js"></script>；也可自托管 photopea.min.js。npm：npm install photopea，然后 import Photopea from "photopea"。
主要能力：Photopea.createEmbed(container) 创建并注入 iframe，就绪后 resolve；new Photopea(window.parent) 用于插件模式包装父窗口；pea.runScript(script) 在 Photopea 内运行 JS 字符串，返回输出数组（app.echoToOE 的值加末尾 "done"）；pea.loadAsset(arrayBuffer) 加载二进制文件；pea.openFromURL(url, asSmart) 打开远程 URL 为新文档或智能对象图层；pea.exportImage(type) 导出当前文档，返回 Blob（"png" 或 "jpg"）。所有方法返回 Promise，需 await 或 .then()。
用法要点：容器 div 调用 createEmbed 前必须有固定宽高。导出 WebP、PSD 或控制质量可用 runScript 配合 saveToOE，如 app.activeDocument.saveToOE("webp:0.85")、saveToOE("psd:true")，格式串含 "png"、"jpg"、"jpg:0.8"、"webp:0.7"、"psd"、"psd:true"、"svg:true"。远程 URL 可作新文档或智能对象，本地文件经 ArrayBuffer 传给 loadAsset。
适用与限制：适合嵌入编辑器、自动化图像编辑或构建编辑类功能，支持文档、图层、文字、选区、滤镜、颜色、路径等脚本操作。资料未提供收费、平台兼容范围与性能数据，暂未提供。