映造 AI/用户端

接口文档

下载 OpenAPI

这些接口用于映造自身的同源登录网页。会话与 CSRF 保护仍然有效，本轮不提供 API Key 或第三方授权。

本人只读调试

仅允许下列固定只读接口。不会创建 AI 任务、写入配置或调用管理接口。

文档调试不开放 AI 写入

运行原创非 AI 示例

将一张服务器内置的原创几何示意图保存到本人素材，再调用真实持久导出。占用少量本人存储，不产生 AI 任务或积分消耗；响应丢失时可用同一意图重试。

非 AI 导出流程

  1. 在素材库上传自己的 PNG/JPEG，记录返回的 fileId。
  2. POST /exports，传入 assetIds、name、filenamePattern 和 allowPartial；发送当前会话 CSRF 与唯一 Idempotency-Key。
  3. 202 表示已持久受理。响应丢失时保留相同参数与键重试，不能换键重复创建。
  4. 每 5 秒读取 /exports/，后台标签页暂停。仅 ready/partial_ready 可下载，部分失败见包内清单。
  5. 通过同源 /exports//content 下载；过期以 /rebuild 新建记录，不修改旧包。

非 AI 处理仍受像素、存储、并发和临时空间限制。例子不包含密码、Cookie、密钥或私有签名地址。

错误与恢复

401：重新登录；403：当前身份不可操作；404：资源不存在或不可见；409：版本/幂等/状态冲突；413：减少文件或像素；429：等待容量恢复；503：保留提交意图后重试。